読み方のヒント

矢印ボタン(または ← → キー)でページを移動できます。

第3節 エージェントからMCPの道具を使う

3.3 起動のときにつなぎ、テストでは同じプロセスでつなぐ

質問のたびにサーバーのプロセスを起動すると、そのたびに時間がかかります。FastAPIの lifespan で、起動のときに一度だけつなぎ、終了のときに閉じます。

@asynccontextmanager
async def lifespan(app: FastAPI):
    # TOOLS_VIA_MCP=true のときは、mcp_server.py を別のプロセスで起動して、その道具を使う
    app.state.mcp_toolbox = None
    if settings.tools_via_mcp:
        app.state.mcp_toolbox = McpToolbox(StdioServerParameters(command=sys.executable, args=["mcp_server.py"]))
    yield
    if app.state.mcp_toolbox:
        app.state.mcp_toolbox.close()

依存関係の get_toolbox は、つないだサーバーがあればそれを、なければ LocalToolbox を返します。初期値は LocalToolbox です。同じプロセスの中で呼ぶほうが速く、/agent だけで使うならMCPは要らないからです。MCPサーバーは、ほかのアプリから同じ道具を使うために用意し、/agent からは設定で切り替えられるようにしておきます。

SDKの Client は、プロセスの代わりに MCPServer そのものを受け取り、同じプロセスの中でつなぐこともできます。テストではこの形を使い、プロセスを起動せずに、MCPのやり取りを通した結果を確かめます。

@pytest.fixture
def mcp_toolbox():
    toolbox = McpToolbox(server)
    yield toolbox
    toolbox.close()


def test_wrong_type_is_an_error(mcp_toolbox):
    output, ok = mcp_toolbox.call("find_products", {"keyword": 3})
    assert not ok
    assert "keyword" in output["error"]
解答例
  1. LocalToolbox。プロセスをまたがないぶん速く、動かすものが少なくて済みます
  2. McpToolbox。道具の中身を自分のアプリに写さず、相手のサーバーの一覧と実行をそのまま使えます。ただし第5節の注意が当てはまります

12 / 22