MCP Documentation Server

MCP ドキュメントサーバー

このプロジェクトでは、Model Context Protocol（MCP）を使用して、さまざまなアプリケーションのドキュメントを提供します。クイックスタートガイドやコード例などのドキュメントコンテンツを、MCP ツールを通じて整理し公開する方法を紹介します。

📚 ドキュメントの構成

アプリケーションのドキュメントは、content/ ディレクトリに整理されています。XYZ アプリケーションのコンテンツは content/xyz/ にあり、次の内容が含まれています。

• quickstart.md：XYZ アプリケーションとの連携方法を説明するクイックスタートガイドです。
• code_examples.md：MCP ツールを使って XYZ アプリケーションを利用する方法を示す、さまざまなコード例です。

🛠️ MCP ツール

ドキュメントコンテンツを公開する MCP ツールは、app/mcp/mcp_routes.py で定義されています。

• quickstart：指定したアプリケーションのクイックスタートガイドを提供します。
• code_examples：指定したアプリケーションのコード例を提供します。

⚙️ セットアップ手順

1. 環境を初期化する

   uv init
   uv venv
   source .venv/bin/activate
   uv pip install fastapi uvicorn openai fastmcp
   uvicorn app.main:app
   

2. アプリケーションサーバーを起動する

   用意されている起動スクリプトを実行します。

   chmod +x scripts/start.sh
   ./scripts/start.sh
   

Claude Desktop から MCP サーバーに接続する

Claude Desktop をこの MCP ドキュメントサーバーに接続するには、Claude の設定に新しいサーバー構成を追加する必要があります。

1. Claude Desktop の設定を開きます。
2. 「Developer」セクションに移動します。
3. 「MCP Server Configs」で、次の JSON 構成を追加します。

{
  "AppDocsServer": {
    "command": "npx",
    "args": [
      "mcp-remote",
      "http://localhost:8000/mcp-app-docs-server/mcp"
    ]
  }
}

4. 設定を保存します。これで Claude Desktop から、このサーバーが提供するツールを検出して使用できるようになります。

MCP Inspector を実行する

このサーバーが公開する MCP ツールをテストして確認するには、MCP Inspector ツールを使用できます。ターミナルで次のコマンドを実行します。

npx @modelcontextprotocol/inspector node build/index.js

これにより Inspector が起動し、このサーバーが提供する quickstart ツールと code_examples ツールを操作できるようになります。