MCP Server Template for Cursor IDE

Cursor IDE 用 MCP サーバーテンプレート

Model Context Protocol（MCP）を使用して、Cursor IDE 用のカスタムツールを作成するためのシンプルなテンプレートです。このテンプレートから独自のリポジトリを作成し、ツールを変更して、Cursor IDE に接続できます。

クイックスタート

1. 「Deploy to Heroku」ボタンをクリックします

   

2. デプロイ後、Cursor を設定します：

   • Cursor の設定 → 機能を開きます
   • 新しい MCP サーバーを追加します
   • /sse パスを付けた Heroku の URL を使用します（例：https://<your-app-name>.herokuapp.com/sse）

3. Cursor でエージェントの気分をテストします：

   • エージェントに「サーバーの気分を尋ねて、どんな様子か教えてください」と尋ねます
   • サーバーは陽気なメッセージとハート ❤️ を返します

その他のセットアップ方法

サーバーは、Docker、従来の Python セットアップ、または Cursor IDE から直接実行する 3 つの方法があります。

Docker のセットアップ

このプロジェクトには、簡単にデプロイできるよう Docker のサポートが含まれています：

1. 初期セットアップ：

# Clone the repository
git clone https://github.com/kirill-markin/weaviate-mcp-server.git
cd weaviate-mcp-server

# Create environment file
cp .env.example .env

2. Docker Compose を使用してビルドし、実行します：

# Build and start the server
docker compose up --build -d

# View logs
docker compose logs -f

# Check server status
docker compose ps

# Stop the server
docker compose down

3. サーバーは次の場所で利用できます：

   • SSE エンドポイント：http://localhost:8000/sse

4. 簡単なテスト：

# Test the server endpoint
curl -i http://localhost:8000/sse

5. Cursor IDE に接続します：
   • Cursor の設定 → 機能を開きます
   • 新しい MCP サーバーを追加します
   • 種類：「sse」を選択します
   • URL：http://localhost:8000/sse を入力します

従来のセットアップ

まず、uv パッケージマネージャーをインストールします：

# Install uv on macOS
brew install uv
# Or install via pip (any OS)
pip install uv

stdio（デフォルト）または SSE トランスポートを使用してサーバーを起動します：

# Install the package with development dependencies
uv pip install -e ".[dev]"

# Using stdio transport (default)
uv run mcp-simple-tool

# Using SSE transport on custom port
uv run mcp-simple-tool --transport sse --port 8000

# Run tests
uv run pytest -v

インストール後、サーバーを Cursor IDE に直接接続できます：

1. Cursor で cursor-run-mcp-server.sh ファイルを右クリックします
2. 「パスをコピー」を選択して、絶対パスをコピーします
3. Cursor の設定（歯車アイコン）を開きます
4. 「機能」タブに移動します
5. 「MCP サーバー」までスクロールします
6. 「新しい MCP サーバーを追加」をクリックします
7. フォームに入力します：
   • 名前：任意の名前を選択します（例：「my-mcp-server-1」）
   • 種類：「stdio」を選択します（サーバーをローカルで実行するため、「sse」ではありません）
   • コマンド：先ほどコピーした cursor-run-mcp-server.sh の絶対パスを貼り付けます。例：/Users/yourname/weaviate-mcp-server/cursor-run-mcp-server.sh

環境変数

使用できる環境変数（.env に設定できます）：

• MCP_SERVER_PORT（デフォルト：8000）- サーバーを実行するポート
• MCP_SERVER_HOST（デフォルト：0.0.0.0）- サーバーをバインドするホスト
• DEBUG（デフォルト：false）- デバッグモードを有効にします
• MCP_USER_AGENT - ウェブサイト取得時に使用するカスタム User-Agent

その他のオプション

Smithery 経由でインストール

Smithery 経由で、Claude Desktop 用 MCP Server Template for Cursor IDE を自動的にインストールするには：

npx -y @smithery/cli install @kirill-markin/example-mcp-server --client claude

Glama サーバーレビュー