MCP 能力与接口
本页汇总当前已实现的 MCP(Model Context Protocol)出站能力。
范围
- ✅ 已实现:Agent 作为 MCP Client 调用外部 MCP Server(出站)。
- ❌ 未实现:Chameleon 作为 MCP Server 对外提供入站能力。
功能清单
- MCP Server 注册与健康检查
- MCP 凭据管理(加密存储 + 轮换)
- Agent 级 MCP 挂载(优先级、allowlist、超时、调用预算)
- 对话编排中的受控工具调用回路
- MCP 调用审计查询(按会话/按 Agent)
接口入口
配置入口
- 配置说明:见 使用指南 / 配置
- 关键项:
[mcp]section、MCP_SECRET_KEY等环境变量
本地 Mock MCP 脚本测试
项目内提供了一个最小可用脚本:/home/atahang/codes/aibot/scripts/mock_mcp_stdio.py。
执行方式
echo '{"action":"tools/call","tool_name":"echo_time"}' | uv run python /home/atahang/codes/aibot/scripts/mock_mcp_stdio.py
示例输出
{"tool": "echo_time", "utc_time": "2026-02-10T03:16:48.411520+00:00", "arguments": {}}
说明:utc_time 为实时时间,每次执行都会不同。
其他常用测试
# Health check
echo '{"action":"health/check"}' | uv run python /home/atahang/codes/aibot/scripts/mock_mcp_stdio.py
# List tools
echo '{"action":"tools/list"}' | uv run python /home/atahang/codes/aibot/scripts/mock_mcp_stdio.py