项目管理机器人

基于企业微信的项目管理机器人系统,支持项目排期、人力资源管理、风险管理和进度跟踪等功能。

  • by Countdown229
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Countdown229/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
    
  2. 安装依赖

    pip install -r requirements.txt
    
  3. 配置机器人

    • 复制 config.json.example 为 config.json
    • 填入企业微信机器人的Webhook URL
  4. 运行系统

    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 文件了解详情

📞 联系方式

🙏 致谢

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