用途:该技能用于向 pi 的 pi-mcp-adapter 添加 MCP 服务器配置,适用于“add mcp server”“configure mcp”“setup mcp”“connect mcp server”等请求场景。流程为确定作用域与服务器类型、写入配置、验证连接。
作用域:全局配置位于 ~/.pi/agent/mcp.json,适合跨项目使用;项目配置位于项目根目录的 .pi/mcp.json,适合单个项目。项目级配置会覆盖全局配置,两者格式相同。
服务器类型:stdio 服务器运行本地命令,配置包含 command、args、env、cwd 等字段;HTTP 服务器连接远程 URL,配置包含 url、headers、auth、bearerToken、bearerTokenEnv 等字段。除 command 或 url 外,其余字段均可选。
其他配置项:lifecycle 可选 lazy(默认,首次调用工具时连接,空闲超时后断开)、eager(会话开始时连接,不自动断开)、keep-alive(启动时连接,断开后自动重连);idleTimeout 为空闲断开分钟数;debug 用于显示服务器 stderr。
写入方式:若目标配置文件已存在则读取,将新服务器合并进现有 mcpServers 对象后写回;若不存在则创建包含 mcpServers 的完整结构。若同名服务器已存在,应先警告并确认后再覆盖。
验证:运行 /reload 加载新配置,使用 mcp({ connect: "server-name" }) 测试连接,使用 mcp({ server: "server-name" }) 列出可用工具,最后报告成功或排查连接错误。
限制:资料未提供该技能的具体安装命令、依赖版本、收费方式及支持平台等信息。