MCP Python SDK Documentation

MCP Python SDK ドキュメント

このリポジトリには、Model Context Protocol（MCP）Python SDK のドキュメントが含まれています。Sphinx と Read the Docs テーマを使用して構築されています。

概要

Model Context Protocol（MCP）は、アプリケーションが大規模言語モデル（LLM）とどのように連携するかを定めたオープン標準です。このドキュメントでは、開発者が次のことを行えるよう支援します。

• MCP の基本概念を理解する
• リソース、ツール、プロンプトを公開する MCP サーバーを構築する
• MCP サーバーに接続する MCP クライアントを作成する
• 高度なトピックとベストプラクティスを確認する

FastMCP

このドキュメントでは、MCP サーバーを構築するための高水準で Python らしいインターフェイスである FastMCP について、包括的に解説しています。もともとは独立したプロジェクトでしたが、FastMCP は公式 MCP Python SDK に統合されました。定型コードを最小限に抑え、開発者にとって使いやすい方法で MCP サーバーを作成できます。

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("Demo 🚀")

@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b

SDK では、サーバーを実行する方法が複数用意されています。

• MCP Inspector を使った開発モード
• Claude Desktop との統合
• カスタムデプロイ向けの直接実行

ドキュメントのビルド

1. 依存関係をインストールする

   まず、Python がインストールされていることを確認します。次に、必要なパッケージをインストールします。

   # Using conda (recommended)
   conda activate cuda_test
   pip install -r requirements.txt
   
   # Or using pip in a virtual environment
   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   pip install -r requirements.txt
   

2. ドキュメントをビルドする

   ドキュメントをビルドするには、次のコマンドを実行します。

   make html
   

   ビルドされたドキュメントは _build/html/ ディレクトリに出力されます。

3. ライブプレビュー

   自動再読み込みに対応したライブプレビューを表示するには、次のコマンドを実行します。

   sphinx-autobuild . _build/html
   

   次に、ブラウザーで http://localhost:8000 を開きます。

GitHub Pages でのホスティング

次の手順に従って、このドキュメントを GitHub Pages でホスティングできます。

1. GitHub リポジトリを作成する

   # Initialize a local repository if you haven't already
   git init
   git add .
   git commit -m "Initial commit with MCP documentation"
   
   # Create a repository on GitHub through the web interface
   # Then add the remote and push
   git remote add origin https://github.com/yourusername/mcp_docs.git
   git push -u origin main
   

2. GitHub Pages を設定する

   ドキュメント向けに GitHub Pages を設定する方法は 2 つあります。

   オプション 1：GitHub Actions を使用する（推奨）

   リポジトリには .github/workflows/docs.yml に GitHub Actions ワークフローがすでに含まれており、main ブランチにプッシュするたびにドキュメントが自動的にビルドされ、GitHub Pages にデプロイされます。

   1. GitHub リポジトリに移動します
   2. 「Settings」>「Pages」に移動します
   3. 「Source」で「GitHub Actions」を選択します
   4. 最初のプッシュ後に「GitHub Actions」ワークフローが実行されていることを確認します

   オプション 2：gh-pages ブランチを使って手動で設定する

   デプロイを手動で管理する場合は、次の手順に従います。

   # Create an orphan gh-pages branch
   git checkout --orphan gh-pages
   git rm -rf .
   touch .nojekyll
   git add .nojekyll
   git commit -m "Initial gh-pages commit"
   git push origin gh-pages
   git checkout main
   
   # Build and copy the documentation to gh-pages
   make html
   git checkout gh-pages
   cp -r _build/html/* .
   git add .
   git commit -m "Update documentation"
   git push origin gh-pages
   git checkout main
   

   次に、GitHub リポジトリの Settings > Pages に移動し、ソースとして gh-pages ブランチを選択します。

3. ドキュメントにアクセスする

   ドキュメントには次の URL からアクセスできます。 https://yourusername.github.io/mcp_docs/

4. ドキュメントを更新する

   ドキュメントを更新する場合は、次の手順に従います。

   # If using GitHub Actions
   # Just push your changes to the main branch
   git add .
   git commit -m "Update documentation"
   git push origin main
   
   # If using manual gh-pages setup
   make html
   git checkout gh-pages
   cp -r _build/html/* .
   git add .
   git commit -m "Update documentation"
   git push origin gh-pages
   git checkout main
   

ドキュメントの構成

• index.rst：メインのエントリーポイント
• introduction.rst：MCP の紹介
• getting-started.rst：スタートガイド
• server-guide.rst：MCP サーバーの構築ガイド
• client-guide.rst：MCP クライアントの構築ガイド
• examples.rst：MCP アプリケーションの例
• advanced-topics.rst：MCP の高度な概念
• api-reference.rst：API リファレンス

貢献

ドキュメントを改善するための貢献を歓迎します。次の手順で貢献できます。

1. リポジトリをフォークします
2. 変更用の新しいブランチを作成します
3. 変更を加えます
4. ドキュメントをビルドして変更を確認します
5. プルリクエストを送信します

リソース

• MCP 公式ウェブサイト
• MCP Python SDK GitHub
• MCP 仕様
• 公式サポート対象サーバー
• GitHub ディスカッション
• FastMCP GitHub（レガシー）

ライセンス

このドキュメントは MIT License の下でライセンスされています。詳細については LICENSE ファイルを参照してください。