Task Manager MCP Wrapper

NPX wrapper for AI-powered task management MCP servers. Provides easy access to intelligent task management and assignment tools through the Model Context Protocol.

功能特性

• 🤖 AI 智能任务规划和分解
• 📋 任务依赖关系管理
• 👥 智能任务分配
• 📊 项目进度跟踪
• 🔗 MCP (Model Context Protocol) 支持
• 📦 NPX 一键安装和使用
• 🗄️ 数据共享: 两个服务器通过 SQLite 数据库共享任务数据
• 🌏 完整中文支持: 完美支持中文字符编码，解决 Unicode 错误
• ⚡ 零依赖安装: 用户无需安装 Python 环境
• 🛡️ 稳定可靠: 修复递归深度问题，防止服务器崩溃
• 🔧 MCP 1.12.0 兼容: 完全兼容最新版本的 MCP 协议

快速开始

MCP 客户端配置

在支持 MCP 的客户端（如 Claude Desktop）中添加以下配置：

{
  "mcpServers": {
    "task-management": {
      "command": "npx",
      "args": ["-p", "task-manager-mcp-wrapper", "task-manager-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    },
    "task-assignment": {
      "command": "npx",
      "args": ["-p", "task-manager-mcp-wrapper", "task-assigner-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

直接使用

# 启动任务管理服务器
npx -p task-manager-mcp-wrapper task-manager-mcp

# 启动任务分配服务器
npx -p task-manager-mcp-wrapper task-assigner-mcp

MCP 服务器说明

task-management

任务管理功能，提供以下工具：

• analyze_task_input: 分析自然语言任务输入
• get_schedule_recommendation: 获取智能调度建议
• predict_task_risks: 预测任务风险
• create_reminder: 创建任务提醒
• update_task_progress: 更新任务进度
• get_next_task_recommendation: 获取下一个任务建议

task-assignment

任务分配功能，提供以下工具：

• decompose_complex_task: 分解复杂任务
• recommend_task_assignment: 推荐任务分配
• assign_task_to_resource: 分配任务给资源
• create_collaboration_plan: 创建协作计划
• review_daily_report: 审查日报

系统要求

• Node.js 14+ (用于 npx)
• Python 3.9+
• OpenAI API 密钥

环境变量

• OPENAI_API_KEY: OpenAI API 密钥（必需）
• OPENAI_BASE_URL: API 基础URL（可选，默认为官方API）

故障排除

常见问题

1. API 密钥未设置: 确保在配置中正确设置 OPENAI_API_KEY
2. 连接错误: 检查网络连接和防火墙设置
3. 版本兼容性: 确保使用最新版本的包

测试连接

# 检查 Node.js 版本
node --version

# 测试任务管理服务器
npx -p task-manager-mcp-wrapper task-manager-mcp

# 测试任务分配服务器
npx -p task-manager-mcp-wrapper task-assigner-mcp

更新到最新版本

# NPX 会自动使用最新版本，无需手动更新
npx -p task-manager-mcp-wrapper@latest task-manager-mcp

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！

更新日志

• v1.2.0: 🎉 重大修复版本
  • ✅ 彻底解决 Unicode 编码错误（UnicodeEncodeError）
  • ✅ 修复递归深度超限问题（maximum recursion depth exceeded）
  • ✅ 添加编码安全处理函数
  • ✅ 改进错误处理和恢复机制
  • ✅ 完全兼容 MCP 1.12.0
  • ✅ 支持中文字符的完整处理流程
• v1.1.1: 包含完整 Python 源码，修复导入问题
• v1.0.11: 修复 MCP 1.12.0 兼容性问题，简化配置
• v1.0.10: 优化路径处理
• v1.0.9: 修复编码问题
• v1.0.8: 初始发布版本