Example MCP Server

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

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

✨ 主な機能

このサーバーは、Docker、従来のPython設定、または直接Cursor IDE内で実行することができます。

📦 インストール

Docker設定

このプロジェクトは、簡単なデプロイのためにDockerをサポートしています。

1. 初期設定：

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

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

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

# サーバーをビルドして起動
docker compose up --build -d

# ログを表示
docker compose logs -f

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

# サーバーを停止
docker compose down

3. サーバーは以下のように利用可能になります：

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

4. 簡単なテスト：

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

5. Cursor IDEに接続します：
   • 「Cursor設定」→「機能」を開きます。
   • 「MCPサーバー」までスクロールします。
   • 「新しいMCPサーバーを追加」をクリックします。
   • フォームを入力します：
     • 名前：任意の名前を選択します（例：「my-mcp-server-1」）
     • タイプ：「sse」を選択します
     • URL：http://localhost:8000/sse を入力します

従来の設定

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

# macOSでuvをインストール
brew install uv
# またはpipでインストール（任意のOS）
pip install uv

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

# 開発依存関係を含むパッケージをインストール
uv pip install -e ".[dev]"

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

# SSEトランスポートとカスタムポートを使用
uv run mcp-simple-tool --transport sse --port 8000

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

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

1. Cursor内の cursor-run-mcp-server.py ファイルを右クリックします。
2. 「パスをコピー」を選択します。
3. ターミナルを開き、パスを貼り付けます。
4. エンターキーを押して実行します。

環境変数

.env ファイルで以下の環境変数を設定できます。

• PORT=8000（デフォルトポート）
• MCP_SERVER_NAME=server-name（サーバー名）

💻 使用例

基本的な使用法

以下のコマンドを使用して、サーバーを起動できます。

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

高度な使用法

SSEトランスポートとカスタムポートを使用する場合：

# SSEトランスポートとカスタムポートを使用
uv run mcp-simple-tool --transport sse --port 8000

📚 ドキュメント

プロジェクトのURL

GitHubリポジトリ