用途:这是一个通用 MCP 客户端技能,用于连接任意 MCP 服务器,并采用渐进式披露,按需加载工具 schema,而不是预先将数千 token 的工具定义塞入上下文。
主要能力:把 MCP 服务器封装为技能,提供列出服务器、列出工具及其完整参数模式、调用工具三类操作。支持多种传输:url + api_key 走 FastMCP Bearer 认证;command + args 走 stdio 本地服务器;url 以 /sse 结尾走 SSE;以 /mcp 结尾走 Streamable HTTP。
使用方式:技能位于 .claude/skills/mcp-client/,脚本路径为 .claude/skills/mcp-client/scripts/mcp_client.py。配置查找顺序为 MCP_CONFIG_PATH 环境变量、技能内 references/mcp-config.json(推荐)、项目根目录 .mcp.json、~/.claude.json。编辑 .claude/skills/mcp-client/references/mcp-config.json 填入 API key,example-mcp-config.json 为模板参考。常用命令: python .claude/skills/mcp-client/scripts/mcp_client.py servers python .claude/skills/mcp-client/scripts/mcp_client.py tools <server_name> python .claude/skills/mcp-client/scripts/mcp_client.py call <server> <tool> '{"arg": "value"}' 依赖安装:pip install mcp fastmcp。
适用场景:需要接入 MCP 服务器(如 Zapier、sequential-thinking 等)并控制上下文占用时;先查配置、再列服务器、列工具、最后调用工具的工作流。
限制:资料未提供支持的服务器完整清单、性能数据、收费信息及其他平台兼容性;错误以 JSON 返回,类型包括 configuration(配置文件未找到)、validation(服务器或工具名无效)、connection(连接失败)。