MCP Server Template for Cursor IDE

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

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

クイックスタート

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

   

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

   • Cursor Settings → Features を開きます
   • 新しい 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 Settings → Features を開きます
   • 新しい MCP サーバーを追加します
   • Type：「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. 「Copy Path」を選択して絶対パスをコピーします
3. Cursor Settings（歯車アイコン）を開きます
4. Features タブに移動します
5. 下にスクロールして「MCP Servers」を表示します
6. 「Add new MCP server」をクリックします
7. フォームに入力します：
   • Name：任意の名前を選択します（例：「my-mcp-server-1」）
   • Type：「stdio」を選択します（サーバーをローカルで実行するため、「sse」ではありません）
   • Command：先ほどコピーした cursor-run-mcp-server.sh の絶対パスを貼り付けます。例：/Users/kirillmarkin/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 用 Cursor IDE 向け MCP サーバーテンプレートを自動的にインストールするには：

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

Glama サーバーレビュー