MCP Python SDK - MCP Python SDK コンテンツにスキップ MCP Python SDK MCP Python SDK * en - English * de - Deutsch * es - español * fr - français * hi - हिन्दी * ja - 日本語 * ko - 한국어 * pt - português (Brasil) * ru - русский язык * tr - Türkçe * uk - українська мова * zh - 简体中文 * zh-hant - 繁體中文 検索 modelcontextprotocol/python-sdk MCP Python SDK modelcontextprotocol/python-sdk * MCP Python SDK MCP Python SDK 目次 * 要件 * インストール * 例 * 作成する * 実行する * 試してみる * まとめ * 次に読むもの * v2 の新機能 * はじめに はじめに * インストール * 最初のステップ * 実際のホストに接続する * テスト * サーバー サーバー * ツール * 構造化出力 * リソース * URI テンプレートとパスの安全性 * プロンプト * 補完 * メディア * エラーの処理 * ハンドラーの中で ハンドラーの中で * Context * 依存関係 * ライフスパン * エリシテーション * マルチラウンドトリップ（multi-round-trip）リクエスト * サンプリングとルート * 進捗 * ロギング * サブスクリプション * サーバーの実行 サーバーの実行 * 既存のアプリに組み込む * デプロイとスケール * 認可 * OpenTelemetry * レガシークライアントへの対応 * Client Client * クライアントのコールバック * クライアントのトランスポート * OAuth クライアント * アイデンティティアサーション * セッショングループ * サブスクリプション * キャッシュヒント * プロトコルバージョン * 非推奨の機能 * 高度なトピック 高度なトピック * 低レベルの Server * ページネーション * ミドルウェア * 拡張機能 * MCP Apps * トラブルシューティング * 翻訳について * Migration Guide: v1 to v2 * API Reference 目次 * 要件 * インストール * 例 * 作成する * 実行する * 試してみる * まとめ * 次に読むもの MCP Python SDK 機械翻訳 このページは英語版ドキュメントから自動翻訳されたものであり、正式な版は 英語版のページ です。不自然な箇所があれば、 翻訳について で報告の方法を説明しています。 このドキュメントの対象は v2（現行の安定版リリース系列） v2 が初めての場合や v1 から移行する場合は、 v2 の新機能 で変更点を 5 分で確認できます。破壊的変更は 移行ガイド がすべて扱っています。まだ v1.x を使っている場合、そのドキュメントは v1.x のドキュメント にあります。わかりにくい点や使いにくい点があれば、 教えてください 。 Model Context Protocol（MCP） を使うと、アプリケーションは標準化された方法で LLM にコンテキストを提供できます。コンテキストを「提供する」という関心事を、LLM とのやり取りそのものから切り離せます。 これはその公式 Python SDK です。この SDK を使うと次のことができます。 * あらゆる MCP ホストにツール、リソース、プロンプトを公開する MCP サーバーを構築 できます。 * あらゆる MCP サーバーに接続する MCP クライアントを構築 できます。 * stdio、Streamable HTTP、SSE という標準のトランスポートすべてを扱えます。 要件 Python 3.10 以上が必要です。 インストール uv pip uv add "mcp[cli]" pip install "mcp[cli]" [cli] エクストラを付けると mcp コマンドが使えるようになります。開発には入れておくことをおすすめします。各依存関係の用途については インストール を参照してください。 例 作成する server.py というファイルを作成します。 server.py from mcp.server import MCPServer mcp = MCPServer ( "Demo" ) @mcp . tool () def add ( a : int , b : int ) -> int : """Add two numbers.""" return a + b @mcp . resource ( "greeting:// {name} " ) def greeting ( name : str ) -> str : """Greet someone by name.""" return f "Hello, { name } !" これだけで完全な MCP サーバーです。 このサーバーは、 ツール を 1 つ（ add ）と、テンプレート化された リソース を 1 つ（ greeting://{name} ）公開しています。 実行する uv run mcp dev server.py これでサーバーが起動し、 MCP Inspector が開きます。サーバーをあれこれ触って試せる対話型の UI です。表示される URL を開いてください。 Note Inspector は Node.js アプリなので、 mcp dev を使うには PATH 上に npx が必要です。 試してみる Inspector で Tools を開き、 a=1 、 b=2 を指定して add を呼び出してください。 3 が返ってきます。✨ Inspector はこのフォーム（ a 用の必須の整数フィールドが 1 つ、 b 用にもう 1 つ）を型ヒントから組み立てました。Claude も、そのほかのあらゆる MCP ホストも同じことをします。 今度は Resources を開き、 greeting://World を読み取ってみてください。 Hello, World! まとめ ここで、 書かなかった ものに改めて目を向けてみましょう。 * JSON Schema はありません。 a: int, b: int がそのままスキーマです。 * リクエストの解析も、シリアライズも、バリデーションのコードもありません。 * プロトコルの処理は一切ありません。 書いたのは、型ヒントと docstring を付けた Python 関数 2 つだけです。残りは SDK が引き受けます。 次に読むもの * はじめに では、インストールから、テストも済んだ動作するサーバーの完成までを案内します。 * MCP サーバーを「使う」側のアプリケーションを作るなら、 クライアント から始めてください。 * すでに FastAPI や Starlette のアプリがあるなら、 既存のアプリに追加する でその中に MCP サーバーをマウントできます。 * 特定のエラーメッセージを探しているなら、 トラブルシューティング がメッセージの文言そのままで引けるように整理されています。 * v2 で何が変わったか気になるなら、 v2 の新機能 が 5 分で読めるツアーです。 * v1 から移行するなら、 移行ガイド から始めてください。 * 正確なシグネチャを探しているなら、 API リファレンス がソースから生成されています。 * LLM と一緒に読んでいるなら、このドキュメントは llms.txt 形式でも公開されています。 llms.txt は各ページの索引で、 llms-full.txt は全ページを 1 つのファイルに収めたものです。 ページトップへ戻る 次 v2 の新機能 Made with Zensical