読み方のヒント
矢印ボタン(または ← → キー)でページを移動できます。
サーバーだけを起動しても、標準入力からのメッセージを待つだけで、何も表示されません。確かめるには、クライアントからつなぎます。次の短いプログラムは、サーバーを子のプロセスとして起動し、一覧の取得と実行を行います。
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