# AI 任务管理系统
这个系统使用FastAPI后端和React前端,通过AI智能体帮助用户规划和管理项目任务。
## 系统功能
- 通过自然语言对话规划项目任务
- 自动分解复杂任务为子任务
- 识别并管理任务间的依赖关系
- 可视化任务流程图
## 快速开始
### 启动服务
```bash
# 给脚本添加执行权限
chmod +x start_services.sh stop_services.sh run_tests.sh
# 启动服务
./start_services.sh
```
首次启动时,系统会提示您输入API密钥和API基础URL。
### 停止服务
```bash
./stop_services.sh
```
### 测试系统
我们提供了两个测试脚本:
1. 综合测试后端API:
```bash
python3 test_backend_comprehensive.py
```
2. 专门测试RouterAgent:
```bash
python3 test_router_agent.py
```
## 环境变量配置
系统需要以下环境变量:
- `OPENAI_API_KEY`: 用于访问AI服务的API密钥
- `OPENAI_BASE_URL`: AI服务的基础URL,默认为 `https://api.nuwaapi.com`
这些变量可以通过以下方式设置:
1. 在系统环境变量中设置
2. 在 `backend/.env` 文件中设置
3. 通过启动脚本交互式设置
## 日志文件
所有日志文件保存在 `logs` 目录下:
- `logs/backend.log`: 后端服务日志
## 故障排除
如果遇到问题,请检查:
1. API密钥是否正确设置
2. API基础URL是否正确
3. 日志文件中的错误信息
## 开发者说明
### 目录结构
- `backend/`: 后端代码
- `src/`: 源代码
- `main.py`: 主入口点
- `logs/`: 日志文件
- `project_documents/`: 项目文档
- `*.sh`: 服务管理脚本
- `*.py`: 测试脚本
Raw data
{
"_id": null,
"home_page": null,
"name": "task-manager-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "mcp, task-management, ai, productivity, project-management",
"author": null,
"author_email": "Task Manager MCP Team <team@taskmanager-mcp.com>",
"download_url": "https://files.pythonhosted.org/packages/21/3e/d628f6715e9dde2bd377b6d6f376b2a023be8b33b0bc75463326ad5c78d3/task_manager_mcp-1.0.0.tar.gz",
"platform": null,
"description": "# AI \u4efb\u52a1\u7ba1\u7406\u7cfb\u7edf\r\n\r\n\u8fd9\u4e2a\u7cfb\u7edf\u4f7f\u7528FastAPI\u540e\u7aef\u548cReact\u524d\u7aef\uff0c\u901a\u8fc7AI\u667a\u80fd\u4f53\u5e2e\u52a9\u7528\u6237\u89c4\u5212\u548c\u7ba1\u7406\u9879\u76ee\u4efb\u52a1\u3002\r\n\r\n## \u7cfb\u7edf\u529f\u80fd\r\n\r\n- \u901a\u8fc7\u81ea\u7136\u8bed\u8a00\u5bf9\u8bdd\u89c4\u5212\u9879\u76ee\u4efb\u52a1\r\n- \u81ea\u52a8\u5206\u89e3\u590d\u6742\u4efb\u52a1\u4e3a\u5b50\u4efb\u52a1\r\n- \u8bc6\u522b\u5e76\u7ba1\u7406\u4efb\u52a1\u95f4\u7684\u4f9d\u8d56\u5173\u7cfb\r\n- \u53ef\u89c6\u5316\u4efb\u52a1\u6d41\u7a0b\u56fe\r\n\r\n## \u5feb\u901f\u5f00\u59cb\r\n\r\n### \u542f\u52a8\u670d\u52a1\r\n\r\n```bash\r\n# \u7ed9\u811a\u672c\u6dfb\u52a0\u6267\u884c\u6743\u9650\r\nchmod +x start_services.sh stop_services.sh run_tests.sh\r\n\r\n# \u542f\u52a8\u670d\u52a1\r\n./start_services.sh\r\n```\r\n\r\n\u9996\u6b21\u542f\u52a8\u65f6\uff0c\u7cfb\u7edf\u4f1a\u63d0\u793a\u60a8\u8f93\u5165API\u5bc6\u94a5\u548cAPI\u57fa\u7840URL\u3002\r\n\r\n### \u505c\u6b62\u670d\u52a1\r\n\r\n```bash\r\n./stop_services.sh\r\n```\r\n\r\n### \u6d4b\u8bd5\u7cfb\u7edf\r\n\r\n\u6211\u4eec\u63d0\u4f9b\u4e86\u4e24\u4e2a\u6d4b\u8bd5\u811a\u672c\uff1a\r\n\r\n1. \u7efc\u5408\u6d4b\u8bd5\u540e\u7aefAPI:\r\n```bash\r\npython3 test_backend_comprehensive.py\r\n```\r\n\r\n2. \u4e13\u95e8\u6d4b\u8bd5RouterAgent:\r\n```bash\r\npython3 test_router_agent.py\r\n```\r\n\r\n## \u73af\u5883\u53d8\u91cf\u914d\u7f6e\r\n\r\n\u7cfb\u7edf\u9700\u8981\u4ee5\u4e0b\u73af\u5883\u53d8\u91cf\uff1a\r\n\r\n- `OPENAI_API_KEY`: \u7528\u4e8e\u8bbf\u95eeAI\u670d\u52a1\u7684API\u5bc6\u94a5\r\n- `OPENAI_BASE_URL`: AI\u670d\u52a1\u7684\u57fa\u7840URL\uff0c\u9ed8\u8ba4\u4e3a `https://api.nuwaapi.com`\r\n\r\n\u8fd9\u4e9b\u53d8\u91cf\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u65b9\u5f0f\u8bbe\u7f6e\uff1a\r\n\r\n1. \u5728\u7cfb\u7edf\u73af\u5883\u53d8\u91cf\u4e2d\u8bbe\u7f6e\r\n2. \u5728 `backend/.env` \u6587\u4ef6\u4e2d\u8bbe\u7f6e\r\n3. \u901a\u8fc7\u542f\u52a8\u811a\u672c\u4ea4\u4e92\u5f0f\u8bbe\u7f6e\r\n\r\n## \u65e5\u5fd7\u6587\u4ef6\r\n\r\n\u6240\u6709\u65e5\u5fd7\u6587\u4ef6\u4fdd\u5b58\u5728 `logs` \u76ee\u5f55\u4e0b\uff1a\r\n\r\n- `logs/backend.log`: \u540e\u7aef\u670d\u52a1\u65e5\u5fd7\r\n\r\n## \u6545\u969c\u6392\u9664\r\n\r\n\u5982\u679c\u9047\u5230\u95ee\u9898\uff0c\u8bf7\u68c0\u67e5\uff1a\r\n\r\n1. API\u5bc6\u94a5\u662f\u5426\u6b63\u786e\u8bbe\u7f6e\r\n2. API\u57fa\u7840URL\u662f\u5426\u6b63\u786e\r\n3. \u65e5\u5fd7\u6587\u4ef6\u4e2d\u7684\u9519\u8bef\u4fe1\u606f\r\n\r\n## \u5f00\u53d1\u8005\u8bf4\u660e\r\n\r\n### \u76ee\u5f55\u7ed3\u6784\r\n\r\n- `backend/`: \u540e\u7aef\u4ee3\u7801\r\n - `src/`: \u6e90\u4ee3\u7801\r\n - `main.py`: \u4e3b\u5165\u53e3\u70b9\r\n- `logs/`: \u65e5\u5fd7\u6587\u4ef6\r\n- `project_documents/`: \u9879\u76ee\u6587\u6863\r\n- `*.sh`: \u670d\u52a1\u7ba1\u7406\u811a\u672c\r\n- `*.py`: \u6d4b\u8bd5\u811a\u672c\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Intelligent Task Management and Assignment MCP Servers",
"version": "1.0.0",
"project_urls": {
"Documentation": "https://task-manager-mcp.readthedocs.io/",
"Homepage": "https://github.com/task-manager-mcp/task-manager-mcp",
"Issues": "https://github.com/task-manager-mcp/task-manager-mcp/issues",
"Repository": "https://github.com/task-manager-mcp/task-manager-mcp"
},
"split_keywords": [
"mcp",
" task-management",
" ai",
" productivity",
" project-management"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b5ef2011b0d0fdf97ec73198078fca40340ae94d2ee83d9db5f7cfd6e2b010d6",
"md5": "5c972ff38301811af1565df1b50fb664",
"sha256": "00da82f9c5d6e5ac0895daf8c14be50d9c6d4fb4f23cec5dcd26c1733a225b4f"
},
"downloads": -1,
"filename": "task_manager_mcp-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5c972ff38301811af1565df1b50fb664",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 45422,
"upload_time": "2025-07-21T14:23:53",
"upload_time_iso_8601": "2025-07-21T14:23:53.289525Z",
"url": "https://files.pythonhosted.org/packages/b5/ef/2011b0d0fdf97ec73198078fca40340ae94d2ee83d9db5f7cfd6e2b010d6/task_manager_mcp-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "213ed628f6715e9dde2bd377b6d6f376b2a023be8b33b0bc75463326ad5c78d3",
"md5": "fed24dcf63c7a0dbf1c06e619804684c",
"sha256": "870db69081290a027fdf7eaeff654e24bdca67a3b56f0bed1afbac84b9c9070a"
},
"downloads": -1,
"filename": "task_manager_mcp-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "fed24dcf63c7a0dbf1c06e619804684c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 60630,
"upload_time": "2025-07-21T14:23:55",
"upload_time_iso_8601": "2025-07-21T14:23:55.493956Z",
"url": "https://files.pythonhosted.org/packages/21/3e/d628f6715e9dde2bd377b6d6f376b2a023be8b33b0bc75463326ad5c78d3/task_manager_mcp-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-21 14:23:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "task-manager-mcp",
"github_project": "task-manager-mcp",
"github_not_found": true,
"lcname": "task-manager-mcp"
}