はじめに
MCP が初めてでも、この SDK が初めてでも、ここから始めてください。ここにあるページでは、何もない状態から、テスト済みの動くサーバーができあがるまでを案内します。SDK をインストールし、最初のサーバーを作り、実際のホストに接続して、インメモリクライアントでテストします。
コードを実行する
コードブロックはすべて、そのままコピーして使えます。どれも完結した、実際に動くファイルです。
一緒に進めるには、コードブロックを server.py に貼り付けて、MCP Inspector で開いてください。
uv run mcp dev server.py
コードを自分で書き（またはコピーし）、編集し、ローカルで実行することを強くおすすめします。自分のエディターで使ってみてこそ、肝心な点が実感できます。書く量がどれほど少ないか、自動補完が効くこと、そして何も実行しないうちに型チェックがミスを見つけてくれることです。
推測に頼る必要はない
このドキュメントの例はすべて、SDK 自身のリポジトリの docs_src/ 以下に置かれた完結したファイルです。そのどれもが、SDK のテストスイートによってインメモリクライアントを通じて実行されています。
import pytest
from mcp import Client
from server import mcp
@pytest.mark.anyio
async def test_add() -> None:
async with Client(mcp) as client:
result = await client.call_tool("add", {"a": 1, "b": 2})
assert result.structured_content == {"result": 3}
サブプロセスも、ポートも、トランスポートもありません。Client(mcp) がサーバーオブジェクトに直接接続します。
SDK への変更によってこれらのページの例が壊れた場合、ページが壊れるより先に CI が赤くなります。ここで読むコードが、実際に動くコードそのものです。
この仕組みはテストで実際に使うことになります。自分のサーバーをテストする方法も、まさにこれです。
次に進む先
サーバーが動くようになれば、残りのドキュメントは講座ではなくリファレンスです。どのページも単独で完結しているので、必要なところへ直接進んでください。