MCP Server For Documentation

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

このリポジトリは、モデルコンテキストプロトコル（MCP）サーバーを実装しています。この MCP サーバーは、与えられたクエリとライブラリを基に最新のドキュメントを検索し、langchain、openai、llama - index をサポートしています。

🚀 クイックスタート

この MCP サーバーは、指定されたクエリとライブラリを使って最新のドキュメントを検索します。以下に、主な機能と使用方法を説明します。

✨ 主な機能

• 与えられたクエリとライブラリを基に最新のドキュメントを検索します。
• langchain、openai、llama - index をサポートしています。

📦 インストール

システム要件

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

インストール手順

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

MacOS/Linux では、以下のコマンドを実行します。

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

インストール後、ターミナルを再起動して uv コマンドを有効にしてください。

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

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

💻 使用例

サーバーの起動

uv run main.py

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

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 を再起動します。

📚 ドキュメント

何が MCP ですか？

MCP（モデルコンテキストプロトコル）は、アプリケーションが LLM にコンテキストを提供する方法を標準化するオープンプロトコルです。MCP は、USB - C インターフェースのように、AI アプリケーションがさまざまなデータソースやツールに接続するための標準的な方法を提供します。

主要な利点

• 増え続ける事前構築済みの統合リストを持ち、LLM が直接接続できます。
• LLM プロバイダーやサプライヤーを切り替える際の柔軟性があります。
• インフラストラクチャ内でデータを保護するためのベストプラクティスがあります。

アーキテクチャの概要

MCP はクライアント - サーバーアーキテクチャを採用しており、ホストアプリケーションは複数のサーバーに接続できます。

• MCP ホスト：Claude Desktop、IDE、AI ツールなど、MCP を通じてデータにアクセスしたいプログラムです。
• MCP クライアント：サーバーと 1:1 の接続を維持するプロトコルクライアントです。
• MCP サーバー：標準化されたモデルコンテキストプロトコルを通じて特定の機能を公開する軽量なプログラムです。
• データソース：ローカル（ファイル、データベース）やリモートサービス（API）など、MCP サーバーがアクセスできるものです。

核心 MCP 概念

MCP サーバーは、3 つの主要な機能タイプを提供できます。

• リソース：ファイルのようなデータで、クライアントが読み取ることができます（API レスポンスやファイル内容など）。
• ツール：LLM が呼び出すことができる関数です（ユーザーの承認が必要です）。
• プロンプト：特定のタスクを完了するのを助ける事前に書かれたテンプレートです。

🔧 技術詳細

トラブルシューティング

サーバーが Claude Desktop に検出されない場合は、以下の点を確認してください。

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