Wecom MCP Client

企业微信项目管理机器人

一个基于MCP (Model Context Protocol) 的企业微信项目管理机器人系统，支持项目排期查询、状态跟踪、风险管理等功能。

🚀 功能特性

核心功能

• 📅 项目排期管理 - 支持项目创建、排期查询、里程碑跟踪
• 👥 人力资源管理 - 人员分配、工作负载监控、资源优化
• ⚠️ 风险管理 - 风险识别、评估、预警和处理
• 📊 进度跟踪 - 实时项目进度更新、阶段管理
• 🤖 智能交互 - 自然语言查询、自动报告生成

企业微信集成

• 💬 发送文本和Markdown格式消息
• 📎 支持文件和图片发送
• 👤 支持@特定用户或全体成员
• 🔔 自动日报和周报推送
• 📱 基于MCP协议的标准化接口

📦 安装要求

pip install -r requirements.txt

依赖包

• requests>=2.25.0 - HTTP请求处理
• pydantic>=1.8.0 - 数据验证和序列化
• typing-extensions>=3.7.4 - 类型注解支持

🛠️ 使用方法

1. 配置企业微信机器人

在 config.json 中配置企业微信机器人的Webhook URL：

{
  "wecom_webhook_url": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY"
}

2. 运行项目管理系统

python main.py

3. 使用MCP客户端

python wecom_mcp_client.py

4. 命令行交互示例

> 查询 TDSQL-2.0-001 的排期
> 当前人力资源状态
> TDSQL转测 TDSQL-2.0-001 @张三
> report  # 生成项目状态报告
> daily   # 发送日报
> weekly  # 发送周报

📁 项目结构

maka0925/
├── main.py                        # 主程序入口
├── wecom_mcp_client.py           # 企业微信MCP客户端
├── project_management_system.py   # 项目管理核心系统
├── wecom_bot_integration.py      # 企业微信机器人集成
├── codebuddy_integration.py      # CodeBuddy集成模块
├── demo_usage.py                 # 使用示例
├── test_integration.py           # 集成测试
├── config.json                   # 配置文件
├── README.md                     # 项目说明
├── requirements.txt              # 依赖包列表
└── .gitignore                   # Git忽略文件

🎯 主要模块说明

ProjectManagementSystem

• 项目生命周期管理
• 人力资源分配和监控
• 风险评估和管理
• 进度跟踪和报告

WeComMCPClient

• MCP协议客户端实现
• 企业微信消息发送
• 文件和图片传输
• 自动报告推送

ProjectManagementBot

• 自然语言处理
• 智能查询响应
• 项目操作执行
• 用户交互管理

🔧 配置说明

环境变量

• WECOM_WEBHOOK_URL - 企业微信机器人Webhook地址
• LOG_LEVEL - 日志级别 (DEBUG/INFO/WARNING/ERROR)

配置文件 (config.json)

{
  "wecom_webhook_url": "企业微信机器人URL",
  "default_projects": {
    "TDSQL-2.0-001": {
      "name": "TDSQL 2.0 核心功能开发",
      "owner": "张三",
      "start_date": "2024-01-15",
      "milestones": {
        "开发启动": "2024-01-15",
        "联调完成": "2024-02-20",
        "转测完成": "2024-03-01",
        "发布上线": "2024-03-30"
      }
    }
  }
}

🚀 快速开始

1. 克隆项目

   git clone https://github.com/Countdown229/wecom-mcp-client.git
   cd wecom-mcp-client

1. 安装依赖

   pip install -r requirements.txt

1. 配置机器人

- 复制 config.json.example 为 config.json - 填入企业微信机器人的Webhook URL

1. 运行系统

   python main.py

📊 使用示例

项目查询

用户: 查询 TDSQL-2.0-001 的排期
机器人: 📅 项目排期信息
       🏷️ 项目名称：TDSQL 2.0 核心功能开发
       🆔 项目ID：TDSQL-2.0-001
       📊 当前阶段：开发中
       ⏰ 下个里程碑：联调完成 (2024-02-20)

项目操作

用户: TDSQL转测 TDSQL-2.0-001 @张三
机器人: ✅ 项目 TDSQL-2.0-001 已成功转入测试阶段
       👤 已通知负责人：@张三
       📅 预计完成时间：2024-03-01

🤝 贡献指南

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

📞 联系方式

• 项目链接:
• 问题反馈: Issues

🙏 致谢

感谢所有为这个项目做出贡献的开发者！