読み方のヒント

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

第2節 MCPサーバーを作る

2.2 サーバーを動かして確かめる

サーバーだけを起動しても、標準入力からのメッセージを待つだけで、何も表示されません。確かめるには、クライアントからつなぎます。次の短いプログラムは、サーバーを子のプロセスとして起動し、一覧の取得と実行を行います。

async def main():
    params = StdioServerParameters(command=sys.executable, args=["mcp_server.py"])
    async with Client(params) as client:
        tools = await client.list_tools()
        for tool in tools.tools:
            print(tool.name, tool.annotations)
        result = await client.call_tool("find_products", {"keyword": "クロワッサン", "quantity": 5})
        print(result.is_error, result.content[0].text)
        result = await client.call_tool("find_products", {"keyword": 3})
        print(result.is_error, result.content[0].text)

このPCでの出力は次のとおりです(一部を省略)。

find_products read_only_hint=True destructive_hint=None ...
search_shop_guide read_only_hint=True destructive_hint=None ...
draft_reservation read_only_hint=False destructive_hint=False ...
False {"products": [{"id": "p002", "name": "クロワッサン", ... "remaining_today": 3, "enough_for_quantity": false}]}
True Error executing tool find_products: 1 validation error for find_productsArguments
keyword
  Input should be a valid string ...

型の合わない引数(keyword に数の3)は、関数が呼ばれる前にSDKが止め、isError の結果を返しました。

道具に付けた注釈(ToolAnnotations)は、クライアントへの知らせです。

注釈意味
read_only_hint読むだけで、何も書き換えない
destructive_hint書き換えるとき、消したり上書きしたりするか
idempotent_hint同じ引数で何度呼んでも、結果が同じか

7 / 22