用途:与 MCP(Model Context Protocol)服务器交互,完成服务器发现、连接、查看工具 schema 及调用工具等操作。当用户消息含 [@mcp:...] 提及时必须加载本技能。
主要能力(六个 mcp_* 工具):mcp_list_servers 列出当前会话中所有 MCP 服务器及连接状态;mcp_connect_server 连接处于 disconnected 状态的服务器并返回真实工具列表;mcp_list_tools 列出已连接服务器的工具,可按 server_name 过滤;mcp_get_tool_schema 获取一个或多个工具的 JSON 输入 schema;mcp_call_tool 在服务器上调用具体工具;mcp_add_server 注册新服务器配置(stdio 或 http);mcp_remove_server 断开、注销工具并删除持久化配置。
使用方式:这些工具不能直接作为独立工具调用,必须通过 run_sdk_snippet 配合 sdk.tool.call 调用,例如 tool.call('mcp_list_servers', {}),返回 Result,先检查 result.ok,再读取 result.content。标准流程为:mcp_list_servers 读取 status,connected 直接进入下一步,disconnected 需先 mcp_connect_server;随后 mcp_get_tool_schema 获取 schema;最后 mcp_call_tool 按 schema 传参调用。注册新服务器先执行 mcp_add_server,再从第一步开始。
规则与限制:不得编造服务器名、工具名或参数名,必须取自上一步结果;调用前应先用 mcp_get_tool_schema,除非本会话已看过 schema;mcp_* 不能作为独立工具调用;应先检查 result.ok,出错向用户反馈而非静默重试。tool_params 必须是 JSON 对象字符串(如 '{"key": "value"}'),无参数传 '{}';mcp_add_server 的 args 必须是字符串列表。mcp_call_tool 支持可选 output_file_path,将结果以 JSON 文件持久化到工作区;路径必须为绝对路径,相对路径会被拒绝并静默回退到运行时目录。
环境变量:可复用 MCP 配置模板中,敏感值可用 ${VAR_NAME} 占位,支持位置包括 url(含查询参数)、headers 值、token、stdio env 值;仅上述字段会被解析,name、description、command、args 中不可使用。不要在技能文档或配置模板中直接写入个人 API 密钥;引用的变量缺失会导致连接失败并报出缺失变量名,密钥值不会写入持久化配置。
适用场景:需要与 MCP 服务器交互的对话或自动化流程,包括列出、连接、检查 schema、调用工具以及注册或移除服务器。费用、价格、平台支持范围等资料暂未提供。