飞书项目MCP服务

基本能力

产品定位

飞书项目MCP服务是一个智能研发流程管理系统，专注于需求管理与开发流程自动化，通过与飞书项目系统的深度集成，提升研发效率和质量。

核心功能

• 需求读取与完整性分析：从飞书项目系统中提取需求文档，进行深度分析并评估需求完整性。
• 需求完善反馈循环：对不完整需求，生成精准的澄清问题清单，并更新需求状态。
• 架构设计与技术方案：基于完整需求，生成全面技术方案，包括项目影响分析与架构决策。
• 代码实现与质量控制：转入代码实现模式，依据技术方案高质量实现功能。
• 自动化代码提交：调用 Gitlab MCP，实现代码自动提交与版本控制。
• 任务状态更新与通知：完成后自动更新飞书项目状态并添加PR评论。

适用场景

• 研发团队的需求管理与自动化流程
• 飞书项目系统的深度集成与自动化扩展
• 开发流程的标准化与效率提升

工具列表

• 健康检查工具：health, health.components, health.integrations, health.tasks, health.memory
• 飞书集成工具：feishu.projects, feishu.requirements, feishu.bugs
• 任务管理工具：task.create, task.get
• 模式工具：mode.analyze, mode.implement

常见问题解答

• 如何配置飞书API凭证：在.env文件中配置FEISHU_APP_ID和FEISHU_APP_SECRET。
• 如何运行服务：使用npm run dev开发模式或npm start生产模式。
• 如何发布到npm：参考文档中的发布步骤，包括构建、测试和发布命令。

使用教程

使用依赖

• Node.js 18+
• 飞书项目系统账号和API凭证

安装教程

# 克隆仓库
git clone https://github.com/yourusername/feishu-project-mcp.git
cd feishu-project-mcp

# 安装依赖
npm install

配置

创建.env文件，配置以下环境变量：

FEISHU_APP_ID=your_app_id
FEISHU_APP_SECRET=your_app_secret
FEISHU_API_URL=https://project.feishu.cn/open_api
PORT=3000
HOST=localhost

运行

# 开发模式
npm run dev

# 生产模式
npm run build
npm start

调试方式

# 健康检查
curl -X POST -H "Content-Type: application/json" -d '{"tool":"health"}' http://localhost:3000/mcp

# 获取飞书项目列表
curl -X POST -H "Content-Type: application/json" -d '{"tool":"feishu.projects"}' http://localhost:3000/mcp

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。