Docs MCP Server

Docs MCP サーバー

このリポジトリには、Model Context Protocol（MCP）サーバーの実装が含まれています。

この MCP サーバーは
""" 指定されたクエリとライブラリについて、最新のドキュメントを検索します。 langchain、openai、llama-index に対応しています。

Args: query: 検索するクエリ（例：「Chroma DB」） library: 検索するライブラリ（例：「langchain」）

Returns: ドキュメントのテキスト """

MCP とは？

MCP（Model Context Protocol）は、アプリケーションが LLM にコンテキストを提供する方法を標準化するオープンプロトコルです。MCP は AI アプリケーション向けの USB-C ポートのようなものだと考えてください。AI モデルをさまざまなデータソースやツールに接続するための標準化された方法を提供します。

主なメリット

• LLM が直接接続できる、事前構築済みのインテグレーションが増え続けています
• LLM プロバイダーやベンダーを柔軟に切り替えられます
• インフラストラクチャ内でデータを保護するためのベストプラクティスを利用できます

アーキテクチャの概要

MCP は、ホストアプリケーションが複数のサーバーに接続できるクライアント・サーバーアーキテクチャに従います。

• MCP ホスト：Claude Desktop、IDE、または MCP 経由でデータにアクセスする AI ツールなどのプログラム
• MCP クライアント：サーバーと 1 対 1 の接続を維持するプロトコルクライアント
• MCP サーバー：標準化された Model Context Protocol を通じて特定の機能を公開する軽量プログラム
• データソース：MCP サーバーがアクセスできるローカル（ファイル、データベース）およびリモートのサービス（API）

MCP の主要な概念

MCP サーバーは、主に 3 種類の機能を提供できます。

• リソース：クライアントが読み取れるファイルのようなデータ（API レスポンスやファイルの内容など）
• ツール：LLM が呼び出せる関数（ユーザーの承認が必要）
• プロンプト：ユーザーが特定のタスクを達成するのに役立つ、事前に作成されたテンプレート

システム要件

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

はじめに

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

MacOS/Linux の場合：

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

その後、uv コマンドが認識されるように、ターミナルを再起動してください。

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

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

# Create a new directory for our project
uv init mcp-server
cd mcp-server

# Create virtual environment and activate it
uv venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate

# Install dependencies
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",  # It's better to use the absolute path to the uv command
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/YOUR/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}

3. Claude Desktop を再起動します

トラブルシューティング

Claude Desktop にサーバーが認識されない場合：

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