task-manager-mcp-wrapper/README.md

Complete task management and assignment MCP servers with 16 AI-powered tools for intelligent task planning, scheduling, risk prediction, team collaboration, and automated workflow management

# 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）中添加以下配置：

```json
{
  "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"
      }
    }
  }
}
```

### 直接使用

```bash
# 启动任务管理服务器
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. **版本兼容性**: 确保使用最新版本的包

### 测试连接

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

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

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

### 更新到最新版本

```bash
# 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**: 初始发布版本