cheers-mcp

v1.0.8

Published

4 months ago

Cheers MCP - AI-powered team collaboration knowledge graph based on Feishu tables. Transform complex team workflows into AI-understandable knowledge graphs, enabling every role to have a dedicated AI collaboration partner.

0High
0Medium
0Low

huanghanzhilian

mcp model-context-protocol feishu team-collaboration ai-assistant knowledge-graph project-management agile backlog sprint task-management

Cheers MCP - AI驱动的团队协作知识图谱

🎉 将复杂的团队协作工作流具像化为AI可理解的知识图谱，让每个岗位都能享受专属的AI协作伙伴

✨ 特性

🤖 专属AI助手 - 为PM、Dev、QA、Release Manager、Designer提供角色专属工具
📊 飞书集成 - 基于飞书多维表格的数据中台（Backlog、Sprint、Task、Artifact、Release）
🚀 多项目支持 - 动态表格发现，零配置切换不同项目
🧠 智能分析 - 项目健康度、关联关系分析、上下文搜索
🔍 高级功能 - 市场研究、竞品分析、知识管理
🌍 多AI支持 - 兼容Claude Desktop、Cursor、ChatGPT等所有MCP客户端

🚀 快速开始

方式一：一键安装（推荐）

无需下载代码，直接在AI助手中使用！

Claude Desktop 配置

打开Claude Desktop配置文件：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
添加以下配置：

{
  "mcpServers": {
    "cheers": {
      "command": "npx",
      "args": ["-y", "cheers-mcp"],
      "env": {
        "FEISHU_APP_ID": "your_app_id",
        "FEISHU_APP_SECRET": "your_app_secret",
        "FEISHU_BASE_TOKEN": "your_base_token"
      }
    }
  }
}

重启Claude Desktop，即可开始使用！

Cursor IDE 配置

打开设置 → Model Context Protocol

添加新的MCP服务器：

名称: cheers
命令: npx
参数: ["-y", "cheers-mcp"]

环境变量:

FEISHU_APP_ID=your_app_id
FEISHU_APP_SECRET=your_app_secret
FEISHU_BASE_TOKEN=your_base_token

VS Code 配置

{
  "mcp": {
    "servers": {
      "cheers": {
        "command": "npx",
        "args": ["-y", "cheers-mcp"],
        "env": {
          "FEISHU_APP_ID": "your_app_id",
          "FEISHU_APP_SECRET": "your_app_secret",
          "FEISHU_BASE_TOKEN": "your_base_token"
        }
      }
    }
  }
}

方式二：全局安装

# 全局安装
npm install -g cheers-mcp

# 设置环境变量
export FEISHU_APP_ID="your_app_id"
export FEISHU_APP_SECRET="your_app_secret"
export FEISHU_BASE_TOKEN="your_base_token"

# 运行服务器
cheers-mcp

🔧 飞书配置指南

1. 创建飞书应用

访问飞书开发者后台
创建企业自建应用
获取 App ID 和 App Secret

2. 权限配置

在应用管理页面添加以下权限：

bitable:app - 多维表格应用权限
bitable:app:readonly - 表格读取权限
bitable:app:write - 表格写入权限

3. 创建数据表格

🎉 智能表格发现：无需手动配置表格ID！

系统会自动识别您的飞书多维表中的表格，只需确保表格名称包含以下关键词：

需求管理表 - 包含 backlog、story、需求、故事 的表格
迭代管理表 - 包含 sprint、iteration、迭代、冲刺 的表格
任务管理表 - 包含 task、todo、任务、待办 的表格
交付物表 - 包含 artifact、deliverable、产物、交付物 的表格
发布管理表 - 包含 release、version、发布、版本 的表格

具体字段结构参考数据表结构文档

🛠️ 可用工具

基础功能

feishu_connect - 测试飞书连接
bind_user_role - 绑定用户角色
get_all_backlogs - 获取需求列表
get_backlog_by_id - 查询需求详情
get_backlog_associations - 关联关系分析

高级分析

get_project_context - 项目健康度分析
search_tasks_by_context - 智能搜索
conduct_market_research - 市场研究
analyze_competitors - 竞品分析

💡 使用示例

PM（产品经理）

# 查看项目整体状况
请帮我分析当前项目的健康度

# 需求管理
显示所有高优先级的需求

# 市场分析
帮我研究一下竞品的定价策略

Dev（开发者）

# 任务查看
我需要查看与"用户登录"相关的所有任务

# 技术分析
分析BK-001需求的技术实现复杂度

QA（测试）

# 测试计划
列出当前Sprint需要测试的功能点

# 质量分析
检查有哪些需求还没有对应的测试用例

🌟 核心优势

🎯 角色驱动设计

每个岗位都有专属的工具集和分析视角，AI助手能够根据用户角色提供最相关的信息。

📈 智能分析引擎

项目健康度 - 自动评估进度、风险、资源配置
关联关系 - 深度分析需求、任务、产出物之间的关系
上下文搜索 - 基于语义的智能搜索，快速定位相关信息

🔄 实时同步

与飞书多维表格实时同步，确保数据的准确性和及时性。

🚀 多项目无缝切换

动态表格发现 - 自动识别不同项目的表格结构
零配置切换 - 只需更改 BASE_TOKEN 即可切换项目
智能映射 - 根据表格命名自动匹配功能模块
并行支持 - 可同时访问多个项目的数据

📖 详细文档

部署指南 - 详细的部署和配置说明
MVP状态报告 - 项目完成情况
API文档 - 完整的API接口说明
数据表结构 - 飞书表格设计

🤝 贡献

欢迎提交Issue和Pull Request！

📄 许可证

MIT License - 详见 LICENSE 文件

🎉 让AI成为你的团队协作伙伴，提升效率，简化流程！