MCP Server Template for Cursor IDE

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 でエージェントのムードをテストします:

   • エージェントに「サーバーのムードについて質問して、その様子を教えてください」と依頼します

   • サーバーは明るいメッセージとハート ❤️ で応答します

Related MCP server: pure.md MCP server

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

サーバーは、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 サーバーを追加します

   • タイプ: 「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. フォームに次のように入力します:

   • 名前: 任意の名前を選択します (例: "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 によるインストール

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

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

Glama サーバーレビュー