MCP Server Tutorial

🚀 MCP ドキュメント検索サーバー

このプロジェクトは、カスタムのMCP（モデル制御プロトコル）サーバーを実装しています。Claudeが、LangChain、LlamaIndex、OpenAIを含む人気のPythonライブラリのドキュメントを検索できるようにします。

✨ 主な機能

• サポートされているライブラリ内で特定のクエリに関するドキュメントを検索します。
• Serperを通じてGoogle Search APIを統合し、関連するドキュメントページを見つけます。
• ウェブページをスクレイピングして、ドキュメントページの内容を抽出します。
• MCPを介してClaude Desktopと連携するように設計されています。

📋 システム要件

• Python 3.10以上
• MCP SDK 1.2.0以上
• uv パッケージマネージャー

🚀 クイックスタート

📦 uvパッケージマネージャーのインストール

MacOS/Linuxの場合：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windowsの場合：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

インストールが完了したら、ターミナルを再起動して、uv コマンドが認識されるようにしてください。uvパッケージマネージャーの詳細については、https://docs.astral.sh を参照してください。

🛠️ プロジェクトのセットアップ

1. プロジェクトを作成して初期化します：

# 新しいディレクトリを作成してプロジェクトを初期化
uv init mcp-server
cd mcp-server

# 仮想環境を作成してアクティブ化
uv venv
source .venv/bin/activate  # Windowsでは：.venv\Scripts\activate

# 依存関係をインストール
uv add "mcp[cli]" httpx

2. サーバー実装ファイルを作成します：

touch main.py

▶️ サーバーの起動

1. MCPサーバーを起動します：

uv run main.py

2. サーバーが起動し、接続を受け入れる準備ができます。

🔗 Claude Desktopへの接続

1. 公式ウェブサイトからClaude Desktopをインストールします。
2. Claude DesktopがあなたのMCPサーバーを使用するように設定します： ~/Library/Application Support/Claude/claude_desktop_config.json を編集します：

{
    "mcpServers": {
        "mcp-server": {
            "command": "uv",  # uvコマンドの絶対パスを使用することをおすすめ
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/YOUR/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}

3. Claude Desktopを再起動します。

🐞 トラブルシューティング

Claude Desktopがサーバーを認識しない場合：

1. 設定ファイルのパスとアクセス権を確認します。
2. 設定内の絶対パスが正しいことを確認します。
3. uvが正しくインストールされ、アクセス可能であることを確認します。
4. Claude Desktopのログにエラーメッセージがないか確認します。