@yidun/dev-mcp-tools

yidun 研发团队使用的 MCP (Model Context Protocol) 工具集，用于增强 AI 编辑器（如 Cursor、Claude Code）的开发能力。

📖 项目介绍

@yidun/dev-mcp-tools 是一个统一的 MCP Server，提供多个开发工具，帮助研发团队更高效地处理日常开发任务。

⚠️ 注意：本工具仅限内部使用。

主要特性

• 🛠️ 模块化设计：每个工具独立维护，便于扩展和管理
• 📝 自带使用规则：通过 Server Instructions 自动注入使用指南，用户无需额外配置
• 🚀 开箱即用：安装后即可使用，自动遵循最佳实践
• 🔧 易于扩展：清晰的架构设计，方便添加新工具

🚀 快速开始

前置依赖

使用 get_popo_doc 工具需要全局安装 Puppeteer：

npm install -g puppeteer

配置

在 Cursor 或 Claude Code 的 MCP 配置文件中添加：

Cursor（~/.cursor/mcp.json）或 Claude Code（~/.claude/mcp.json）：

{
  "mcpServers": {
    "dev-mcp-tools": {
      "command": "npx",
      "args": ["@yidun/dev-mcp-tools@latest"],
      "env": {
        "OVERMIND_CLIENT_ID": "你的 CLIENT_ID",
        "OVERMIND_SECRET": "你的 SECRET",
        "OUTPUT_DIR": "/path/to/save/popo/docs"
      }
    }
  }
}

环境变量

• OVERMIND_CLIENT_ID（必需）：Overmind API 客户端 ID
• OVERMIND_SECRET（必需）：Overmind API 密钥
• OVERMIND_PRODUCT_ID（可选）：默认产品 ID，默认为 177
• OUTPUT_DIR（可选）：get_popo_doc 工具保存文档的目录；未配置时仅返回文档内容不落盘

📦 可用工具

1. get_requirement

根据需求编号或需求链接获取 Overmind 需求详情。

使用示例：

获取需求详情 https://overmind.hz.netease.com/177/requirement/issues/OMSEC-147219

功能说明：

• 返回需求标题、详情、图片、关联资源、附件、备注和子任务等完整信息
• 自动遵循最佳实践的使用流程（需求分析 → 方案制定 → 代码实现）

2. get_popo_doc

获取 POPO 文档内容并自动转换为 Markdown 格式。

使用示例：

获取 POPO 文档 https://docs.popo.netease.com/lingxi/3360f0e6932d443a91e14323f06741f3

功能说明：

• 自动提取 POPO 文档内容并转换为 Markdown 格式
• 智能识别文档类型（Markdown/富文本）并进行相应处理
• 当 MCP 配置了环境变量 OUTPUT_DIR 时，会将文档保存到该目录（文件名：<标题>_<时间戳>.md）；未配置时仅返回内容不落盘
• 首次使用需手动登录，之后会自动登录（Cookie 缓存）

🔨 本地开发

安装依赖

npm install

开发模式

npm run dev

构建

npm run build

发布

npm version patch  # 或 minor, major
npm publish

📝 添加新工具

1. 在 src/tools/ 下创建新工具目录
2. 创建 index.ts（Tool 定义）、handler.ts（业务逻辑）、instructions.ts（使用规则）
3. 在 src/index.ts 中注册新工具
4. 在 src/instructions.ts 中聚合新工具的使用规则
5. 更新本 README

📄 许可证

ISC

🤝 贡献

本工具仅限 yidun 研发团队内部使用。