MCP 快速配置

🚀 一键交互式安装 MCP 配置（支持 CodeBuddy / CodeBuddy 插件）

团队成员只需运行一条命令，即可交互式选择 IDE 插件、配置 MCP Server，自动写入对应的 mcp.json。

使用方式

npx @plugin-light/mcp-setup

支持的 IDE 插件

| IDE 插件 | 配置路径 | |----------|---------| | CodeBuddy | ~/.codebuddy/mcp.json | | CodeBuddy 插件 | ~/.gongfeng-copilot/mcp.json |

支持的 MCP Server

| MCP | 说明 | 需要 Token | |-----|------|:---------:| | PMD MCP | 项目发布工具（H5/小程序/NPM 发布、文件上传、PB 转 TS 等） | ✅ enterpriseId + pmdRtoken | | Press MCP | Press UI 组件文档查询与发布 | ✅ enterpriseId + pmdRtoken | | KM | KM 知识库搜索与读取 | ✅ taiPAT | | iWiki | iWiki 知识库搜索与读取 | ✅ taiPAT | | 工蜂 (Gongfeng) | 工蜂代码仓库操作（搜索项目、MR、Issue、文件读写等） | ✅ taiPAT | | TAPD | TAPD 需求/缺陷/任务管理 | ✅ tapdToken | | TDesign MCP | TDesign 组件文档查询（支持 Vue/React/UniApp/小程序） | ❌ |

💡 相同的占位符（如 enterpriseId、taiPAT）只需输入一次，会自动复用到所有用到该值的 MCP。

功能特性

• 🖥️ 多 IDE 支持：可同时配置 CodeBuddy 和 CodeBuddy 插件，一次输入多处写入
• 🎯 交互式选择：可选择安装全部或部分 MCP
• 🔑 安全输入：Token 输入时以 * 遮蔽，不会明文显示
• 📦 智能合并：自动检测并保留已有配置
• 💾 自动备份：写入前自动备份原配置为 mcp.json.backup
• 🚫 零依赖：仅使用 Node.js 内置模块，无需额外安装

运行流程

flowchart TD
    A["�️ Step 0: 选择目标 IDE 插件"] --> B["📋 Step 1: 选择要安装的 MCP Server"]
    B --> C["🔑 Step 2: 逐个配置 Token\n（同一占位符只问一次）"]
    C --> D["👀 Step 3: 预览写入计划\n（分别展示每个 IDE 的变更）"]
    D --> E["✅ 确认写入"]
    E --> F["💾 逐个 IDE 备份 + 合并写入"]
    F --> G["🎉 配置完成，重启 IDE 生效"]

Token 获取方式

PMD MCP / Press MCP

| 占位符 | 说明 | 获取方式 | |--------|------|---------| | <enterpriseId> | 企业微信 ID | 如 zhangsan | | <pmdRtoken> | PMD rtoken | 研发平台 → Token 管理 → 创建 |

KM / iWiki / 工蜂

| 占位符 | 说明 | 获取方式 | |--------|------|---------| | <taiPAT> | TAI 个人访问令牌（tai_pat_xxx） | TAI → 个人访问令牌 → 创建 |

TAPD

| 占位符 | 说明 | 获取方式 | |--------|------|---------| | <tapdToken> | TAPD 个人令牌 | TAPD → 我的主页 → 个人令牌 |

扩展新的 MCP

只需编辑 bin/mcp-template.json：

flowchart LR
    A["在 mcpServers 中\n添加新配置"] --> B["用 placeholder 占位符标记\n需要用户输入的值"]
    B --> C["在 _placeholders 中\n添加占位符说明"]
    C --> D["运行 npx @plugin-light/mcp-setup\n自动识别新 MCP"]

无需修改 setup.mjs 代码。

发布

npm publish --access public

开发

# 本地测试
node bin/setup.mjs