Web Content Retriever

🚀 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内で直接実行する3つの方法で起動できます。

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
# または、任意のOSでpipを使用してインストールする
pip install uv

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

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

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

# カスタムポートでSSEトランスポートを使用する
uv 実行 --port=8000 mcp-simple-tool

# サーバーを停止する
uv 停止

直接Cursorで実行

このテンプレートをCursor IDE内で直接実行する場合は、以下の手順に従ってください。

1. プロジェクトを開き、依存関係をインストールする

pip install -r requirements.txt

2. サーバーを起動する

uv 実行 mcp-simple-tool

🔧 環境変数

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

📚 ドキュメント

このテンプレートを使用すると、Cursor IDEとの対話に使用するMCPサーバーを迅速に作成およびデプロイできます。必要に応じて、mcp-simple-tool.py ファイル内のロジックを変更できます。

その他のリソース

• MCPプロトコルドキュメント
• Cursor IDE公式ドキュメント