AI 工具设置助手
用 Desktop Commander 安装、连接、验证和修复 Claude Desktop 与 MCP 服务器。
该技能明确要求备份配置、验证修改、不泄露密钥,并强调只添加可信的MCP服务器,体现了良好的安全实践。但缺少用户确认机制、数据流透明度及明确的外部影响说明,且依赖的配置修改可能影响系统级设置,权限控制不完全,故扣分。
技能提供了清晰的诊断步骤和故障排除清单,但依赖外部文档和网络资源,未提供自动化测试覆盖关键路径,静态审查无法验证实际可靠性,故降分。
技能明确了目标场景(配置Claude Desktop和MCP服务器)和触发症状,提供了多种平台路径,但对能力边界和非适用场景描述有限,且依赖海外服务(如Nous Portal、OpenClaw),对大陆用户可能不友好,故扣分。
文档结构清晰,包含版本、受众、描述和详细参考文件,但缺少更新日志、维护责任说明和已知限制,版本号与技能内容可能不一致,故扣分。
技能逻辑完整,步骤可执行,但静态审查无法验证实际效果,且外部依赖可能变化,输出未经验证,故扣分。
技能引用了外部文档和GitHub,但没有具体的测试结果或第三方验证证据,静态审查无法独立复现,故扣分。
- 技能依赖的MCP服务器和外部服务(如Nous Portal、OpenClaw)可能无法从中国大陆网络访问,需考虑网络可及性。
- 技能中提到的配置修改会影响系统环境,使用时需确保用户确认并备份,避免误操作。
- 技能未提供明确的错误处理和回滚机制,遇到异常时应谨慎操作。
这个 Skill 能做什么,适合哪些场景?
此技能指导 AI 代理帮助用户在其自己的机器上设置和修复 AI 工具,专注于配置和故障排除而非全新安装。它涵盖安装 Claude Desktop、添加和修复 MCP 服务器、诊断连接问题,以及连接本地 AI 网关如 OpenClaw 和 Hermes。该技能强调安全实践,如备份配置、验证更改和保守秘密。
该技能读取 config 文件,如 mcp.json 和 claude_desktop_config.json,以检查当前配置。它使用终端命令(通过 start_process)检查系统信息、验证 API 密钥、测试模型端点,并通过列出进程和检查端口来确认服务正在运行。它编辑配置文件(使用 edit_block 或 write_file)以添加或修改 MCP 服务器条目,在更改前备份文件,并验证 JSON 语法。它还提供结构化的故障排除指南,用于诊断“代理不响应”的问题,例如检查认证、模型支持、进程状态和日志。
- 用户报告“Claude 看不到我的工具” - 技能会检查 MCP 配置并验证服务器是否正确列出。
- 用户想要“添加 MCP 服务器” - 技能编辑正确的配置文件并验证连接。
- 用户说“我的 MCP 服务器没有显示出来” - 技能诊断配置错误和进程问题。
- 用户想要“连接 Ollama 或 LM Studio” - 技能协助配置本地模型提供者。
- 用户需要“重启 Claude Desktop” - 技能指导通过进程管理安全重启。
- 用户使用 OpenClaw 或 Hermes 网关遇到问题 - 技能提供配置和诊断步骤。
这个 Skill 有哪些优点和局限?
- 侧重安全性:备份配置,避免回显秘密,验证更改。
- 明确的故障排除工作流程,涵盖常见症状。
- 覆盖多个工具(Claude Desktop、MCP、OpenClaw、Hermes)。
- 可重复结果,建议保存步骤。
- 未记录安装步骤;需要手动设置。
- 依赖外部 MCP 服务器(Desktop Commander),需要额外安装。
- 没有明确的测试套件或版本历史。
- 跨平台行为可能因 OS 而异;未经验证。
如何安装这个 Skill?
此技能位于 Desktop Commander MCP 仓库中。它包含在更广泛的集合中,该集合适用于支持 Agent Skills 的 MCP 客户端(如 Cursor)。目前,安装的详细步骤在提供的源材料中未记录。但是,仓库提供了基于 MCP 的标准安装方法(例如,通过 npx 或手动 config 添加)。要将此技能添加到您的代理,可能需要将其 SKILL.md 文件复制到您的技能目录,或使用支持技能加载的客户端。
如何使用这个 Skill?
触发技能后,它将读取相关的 reference 文件(例如,references/claude-desktop-mcp.md)以获取具体路径和命令。遵循一般工作流程:1. 澄清目标和平台;2. 检查当前状态(读取 config、列出进程);3. 进行最小更改,先备份;4. 验证结果;5. 总结更改和撤销方法。示例触发提示:“修复我的 MCP 配置”或“Claude 看不到我的工具”。