返回目录 / MCP 客户端
在Agent使用前检查MCP工具清单与副作用
在把远程MCP工具提供给Agent前检查名称、描述、schema、权限和副作用。
目标
只允许Agent调用经过人工审阅且符合任务所需权限的工具。
步骤
- 先用MCP
Client.list_tools()审阅name、description与input_schema;本地Agent接入时从可信server获取完整清单。 [openai-mcp] [mcp-client] - 在
MCPServerStdio/MCPServerStreamableHttp设置tool_filter=create_static_tool_filter(allowed_tool_names=[...])仅暴露审核通过项。 [openai-mcp] [mcp-client] - 对写入工具配置
require_approval="always",再按应用权限将已批准server交给Agent。 [openai-mcp] [mcp-client] - 将已批准工具显式加入Agent配置,按需禁用其他工具。 [openai-mcp] [mcp-client]
- 用工具清单回归测试确保新增远程工具不会自动获得Agent访问权。 [openai-mcp] [mcp-client]
验证方式
保留逐项工具审阅记录;测试新增工具默认不可用,除非进入批准清单。
故障处理
若意外出现新工具,确认配置显式allowlist,而非自动接受全部发现项。
权限边界
前置条件
- Python 3.10+、固定提交兼容的Model Context Protocol Python SDK
- openai-agents与获准模型提供商凭据(仅执行Agent推理时需要)
权限边界
- 只在本地或隔离测试环境操作;涉及外部数据或副作用时使用最小权限并先审批
限制
SDK行为可能随版本变化;固定来源仅说明其提交中的实现,不代表其他Agent或客户端完全兼容。生产环境需独立审阅数据保留、授权和副作用。
固定上游来源
- 仓库
- modelcontextprotocol/python-sdk
- 文件路径
- docs/servers/tools.md
- 固定提交
754254c08fe1c3eda18b69da3d336106fe8d72d6- 来源检查
- 2026-10-14 · 已按固定上游来源核对
仓库指标
以下数字属于上游仓库整体,不代表单个 Skill 或指南的点赞/热度。
- Stars
- 未取得
- Forks
- 未取得
- 观测时间
- 未取得
尚未取得指标快照。
许可证: MIT