MCP 服务器配置师

要解决的问题

手动接入一个新的 MCP（Model Context Protocol）服务器时，开发者通常要在本地配置文件 mcp.json 里拼凑 command、args、env、headers、url 等字段。格式细节因平台而异，参数顺序、环境变量写法稍有不慎就会导致连接失败；更麻烦的是，很多人会把 API 密钥直接写进配置明文里，一旦配置文件被读取或提交到仓库，密钥就泄露了。这个技能解决的就是「配置怎么写、密钥放哪、文件怎么生效」这三件事。

核心能力

• 按需求生成配置片段：你给出目标平台名称或官方文档 URL，技能按 mcp.json 的格式要求生成配置，并标注哪些是必填项。
• 安全审查：检查密钥是否被硬编码进配置，建议改用环境变量引用，并给出隔离存储的建议。
• 写入指引与执行：提供写入 ~/.workbuddy/mcp.json 的步骤，提醒写入后到连接器管理页点击信任启用；在确认后可代为写入文件。

工作流

1. 接收需求：平台名或文档 URL。
2. 生成配置：产出 mcp.json 片段，标注必填项。
3. 安全审查：密钥走环境变量，不落明文。
4. 写入指引：给出路径与启用步骤。
5. 执行写入：需用户二次确认；若平台未开启「允许完全访问」，则只产出片段由你手动粘贴。

适用边界与注意点

• 本技能只写 mcp.json，不触碰其他文件，异常即停。
• 执行写入需要平台开启「允许完全访问」（不同平台可能叫「完全磁盘访问」「跳过操作确认」「沙箱外执行」等）。未开启时只能拿到配置草稿，文件不会真正生效。
• 写入完成后，必须到连接器管理页手动点「信任启用」才算接好，不要以为文件写完就结束了。
• 术语对照见技能自带的词库文件 references/词库.md。