読み方のヒント
矢印ボタン(または ← → キー)でページを移動できます。
質問のたびにサーバーのプロセスを起動すると、そのたびに時間がかかります。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"]
LocalToolbox。プロセスをまたがないぶん速く、動かすものが少なくて済みますMcpToolbox。道具の中身を自分のアプリに写さず、相手のサーバーの一覧と実行をそのまま使えます。ただし第5節の注意が当てはまります12 / 22