MCP Server Template For Cursor IDE

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

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

🚀 クイックスタート

1. 「Herokuにデプロイ」ボタンをクリックします。

   

2. デプロイが完了したら、Cursorを設定します。

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

3. Cursorでエージェントのムードをテストします。

   • エージェントに「サーバーのムードを教えてください。」と尋ねます。
   • サーバーは愉快なメッセージと❤️で応答します。

✨ 主な機能

サーバーを3つの方法で実行できます：Dockerを使用する方法、従来のPython設定を使用する方法、または直接Cursor IDE内で実行する方法です。

📦 インストール

Docker設定

このプロジェクトには、デプロイを容易にするためのDockerサポートが含まれています。

基本的な使用法

# リポジトリをクローンする
git clone https://github.com/kirill-markin/weaviate-mcp-server.git
cd weaviate-mcp-server

# 環境ファイルを作成する
cp .env.example .env

高度な使用法

# サーバーを構築して起動する
docker compose up --build -d

# ログを表示する
docker compose logs -f

# サーバーの状態を確認する
docker compose ps

# サーバーを停止する
docker compose down

3. サーバーは以下のアドレスで利用可能になります。
   • SSEエンドポイント：http://localhost:8000/sse

高度な使用法

# サーバーエンドポイントをテストする
curl -i http://localhost:8000/sse

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

従来の設定

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

基本的な使用法

# macOSでuvをインストールする
brew install uv
# または、どのオペレーティングシステムでもpipを使用してインストールする
pip install uv

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

高度な使用法

# 開発依存関係を使用してパッケージをインストールする
uv pip install -e ".[dev]"

# stdioトランスポート（デフォルト）を使用する
uv run mcp-hitchcode

# カスタムポートのSSEトランスポートを使用する
uv run mcp-hitchcode --transport sse --port 8000

# テストを実行する
uv run pytest -v

インストールが完了したら、サーバーを直接Cursor IDEに接続できます。

1. Cursorで「mcp-server」フォルダを右クリックします。
2. 「.Cursorに追加」を選択します。
3. 上記のようにパラメータを設定します。

環境変数

以下は一般的な環境変数とその意味です。

⚠️ 注意事項

⚠️ 重要提示

1. すべての環境変数が正しく設定されていることを確認してください。
2. サーバーをテストする前に、依存関係がすべてインストールされていることを確認してください。
3. 問題が発生した場合は、ドキュメントまたはコミュニティサポートを参照してください。