add-mcp Skill 技能

技能简介

add-mcp 是一个面向编码 Agent 的 MCP 服务器配置工具，主张"一条命令装上 MCP 服务器"。它解决的是当前 AI 编程工具林立、每家配置文件格式与路径各不相同带来的痛点：你不再需要为 Claude Code、Codex、Cursor、OpenCode、VS Code、Windsurf、Zed 等二十多个 Agent 分别手写 .mcp.json 或 config.toml，只需一条 npx add-mcp 命令，即可把远程 URL 或包名的 MCP 服务器写入正确位置，并自动识别项目级与全局级配置路径。

核心能力

• 一条命令把 MCP 服务器安装到目标编码 Agent，无需手动编辑配置
• 支持远程 URL 与包名两种安装方式，远程走 HTTP 类型，本地走 stdio 类型
• 覆盖 20 多个主流 Agent，自动区分项目级与全局级配置路径
• 支持 --env、--args、--header 参数，为服务器补充环境变量、启动参数与请求头
• 通过 ${VAR} 占位符实现交互式安装，逐项提示填写变量，并跳过留空的可选项
• 提供 add-mcp find 搜索 add-mcp 注册表，一键查找并安装 MCP 服务器
• 提供编程 API（upsertServer），可把 add-mcp 集成进自己的 CLI 工具

安装配置

• 无需全局安装，直接用 npx 调用：

npx add-mcp url | package name [options]

• 安装远程 MCP 服务器（以 Context7 为例）：

npx add-mcp https://mcp.context7.com/mcp

• 首次执行 find / search 会自动把 add-mcp 注册表缓存到 ~/.config/add-mcp/config.json（或 $XDG_CONFIG_HOME/add-mcp/config.json），可自行替换为官方 Anthropic 注册表或任意兼容注册表
• 支持的 Agent 包括 Antigravity、Cline、Claude Code、Claude Desktop、Codex、Cursor、Gemini CLI、Goose、Kilo Code、Kimi Code、Kiro、OpenCode、Pi、VS Code、Windsurf、Zed 等，并支持别名（如 gemini → gemini-cli）

使用步骤

1. 在终端执行 npx add-mcp 并传入远程 URL 或 npm 包名
2. 如目标环境有多个 Agent，用 --agent 指定要写入哪一个（不指定时按默认 Agent 处理）
3. 如需项目级配置，加上 --local；需要写入用户全局配置则保持默认
4. 服务器需要密钥、参数或请求头时，用 --env、--args、--header 补充；含 ${VAR} 时按提示交互填写
5. 不确定服务器名称时，先 npx add-mcp find 搜索注册表，再安装
6. 重启（或按对应 Agent 的 reload 方式重载）会话，确认 MCP 服务器已生效

适用场景

• 多工具统一切换：团队同时使用 Claude Code、Cursor、Codex 等多种 Agent，用一条命令保持 MCP 配置一致
• 快速试用新 MCP 服务器：从注册表里发现一个服务器后，立即装到本地验证，无需研究各家的配置格式
• 项目级配置分发：把 MCP 服务器写入项目内配置文件，随仓库一起提交，让协作成员开箱即用
• CI 与自助工具集成：借助 upsertServer 编程 API，把 MCP 安装能力嵌入自研 CLI 或自动化脚本
• 注册表个性化：把默认注册表替换为内部或官方注册表，统一团队的服务器来源

适用人群

适合日常使用多个 AI 编码 Agent 的开发者、需要统一团队 MCP 配置的技术负责人，以及希望把 MCP 安装流程集成进自有工具链的平台工程师。

工作原理

add-mcp 内置了一份各 Agent 的配置文件映射表，记录了每个 Agent 读写的项目级与全局级配置路径及其格式（JSON、TOML、YAML 等）。执行安装时，它根据 --agent 与 --local 判定目标文件，把服务器条目按目标格式写入，并在混合配置文件场景下保留原有结构（例如 OpenCode 在已有原生 map 时写入 mcp.servers.，否则写 V1 形态）。它只负责写入正确的配置位置，不负责服务器本身的运行与鉴权。

官方链接

• npm 包：https://npmjs.com/package/add-mcp
• 源码仓库：https://github.com/neon-solutions/add-mcp
• 官网与注册表：https://add-mcp.com