Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (task-manager-mcp-wrapper) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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）

故障排除

常见问题

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

测试连接

# 检查 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: 初始发布版本