向 Agent 提供进程内只读 MCP 工具

目标

让 Agent 调用受控业务函数而无需单独启动 MCP 子进程。

步骤

1. 用 @tool(name, description, input_schema) 定义函数，校验输入并限制其数据源为只读接口。 [mcp]
2. 用 create_sdk_mcp_server(name=..., version=..., tools=[...]) 创建服务器，并在 ClaudeAgentOptions(mcp_servers={...}) 注册。 [mcp]
3. 仅将 mcp__<server>__<tool> 名称加入 allowed_tools，用虚构数据请求并检查 ToolUseBlock/ToolResultBlock。 [mcp]

验证方式

Agent 只能调用预期工具；越界参数被应用函数拒绝，错误结果带 `is_error`。

故障处理

如果工具未出现，核对 server key、工具名和 allowed_tools 全名；若结果格式错，按 content text block 返回。