搭建只读MCP工具服务器供Agent查询

目标

通过MCP提供可发现、参数受限且无写入副作用的查询。

步骤

1. 挑选单一只读业务查询，并从数据层授予最小读取权限。 [mcp-tools] [mcp-errors]
2. 用 @mcp.tool() 注册函数，以类型提示定义输入；通过 Annotated[int, Field(ge=1, le=50)]限制分页参数。 [mcp-tools] [mcp-errors]
3. 若用工具注解声明 read_only_hint=True，记住它只是客户端提示；真正只读必须由数据库/服务权限强制。 [mcp-tools] [mcp-errors]
4. 把异常转换为受控MCP错误，不返回堆栈、连接串或秘密。 [mcp-tools] [mcp-errors]
5. 用有效、越权、无效及超大分页请求测试服务器，确认数据层拒绝写入。 [mcp-tools] [mcp-errors]

验证方式

测试应证明工具只读取授权范围，且异常输出不包含内部实现细节。

故障处理

若测试能修改数据，在数据层强制只读权限，不要依赖工具描述约束。