読み方のヒント

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

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

3.2 MCPのクライアントを道具箱に包む

MCPのSDKは非同期(async)で書かれています。run_agent は同期の関数のため、SDKを別のスレッドで動かし、そこへ仕事を頼む形でつなぎます。anyioの start_blocking_portal が、この仕組みを用意しています。

class McpToolbox:
    def __init__(self, server):
        self._stack = ExitStack()
        self._portal = self._stack.enter_context(start_blocking_portal())
        self._client = self._stack.enter_context(self._portal.wrap_async_context_manager(Client(server)))
        listed = self._portal.call(self._client.list_tools)
        self.tools = {tool.name: tool for tool in listed.tools}

    def specs(self) -> list[dict]:
        return [
            {"type": "function", "function": {"name": t.name, "description": t.description or "", "parameters": t.input_schema}}
            for t in self.tools.values()
        ]

    def call(self, name: str, arguments: dict | str) -> tuple[dict, bool]:
        if name not in self.tools:
            return {"error": f"{name} という道具はありません。使える道具:{', '.join(self.tools)}"}, False
        result = self._portal.call(self._client.call_tool, name, arguments)
        text = "\n".join(block.text for block in result.content if block.type == "text")
        if result.is_error:
            return {"error": text}, False
        output = json.loads(text) if text.startswith("{") else {"text": text}
        return output, "error" not in output

specs() は、サーバーの input_schema を、そのまま tools の parameters に入れています。MCPの道具の一覧と、Ollamaの tools は、どちらもJSON Schemaで引数を表すため、包み直すだけで渡せます。

コマンドで試すときは --mcp を付けます。

python run_agent_cli.py --mcp "クロワッサンは今日まだありますか"
道具: find_products {'keyword': 'クロワッサン'} ok=True
答え: クロワッサンは残り3個あります。

11 / 22