Tama - AI-Powered Task Manager CLI ✨

基本能力

产品定位

TAMA-MCP 是一个AI增强的命令行任务管理工具，旨在帮助开发者高效管理任务，特别是通过AI能力解析PRD和扩展任务。

核心功能

1. 标准任务管理：添加、列出、显示详情、更新状态和删除任务及子任务。
2. AI驱动的PRD解析：从 .txt 或 .prd 文件自动生成结构化任务列表。
3. AI驱动的任务扩展：将高级任务分解为详细的子任务。
4. 依赖检查：检测任务中的循环依赖。
5. 报告生成：以Markdown表格或Mermaid依赖图形式生成任务报告。
6. 代码存根生成：根据任务详情创建占位代码文件。
7. 下一个任务建议：根据状态和依赖关系识别下一个可执行任务。
8. 丰富的CLI输出：使用 rich 库提供格式化和视觉吸引的终端输出。

适用场景

1. 项目管理：管理个人或团队的任务和子任务。
2. PRD解析：自动从产品需求文档生成任务列表。
3. 任务分解：将复杂任务分解为可执行的子任务。
4. 依赖管理：检查和可视化任务之间的依赖关系。
5. 代码生成：根据任务描述生成占位代码文件。

工具列表

1. get_task：通过ID查找并返回任务或子任务。
2. find_next_task：查找下一个可执行任务。
3. set_task_status：设置任务或子任务的状态。
4. add_task：添加新的主任务。
5. add_subtask：添加新的子任务。
6. remove_subtask：删除子任务。
7. get_tasks_table_report：生成表示任务结构的Markdown表格。

常见问题解答

1. 如何配置API密钥？
2. 在项目根目录创建 .env 文件，并添加 DEEPSEEK_API_KEY="your_deepseek_api_key_here"。
3. 如何启动MCP服务器？
4. 运行 uv --directory /path/to/your/TAMA_MCP run python -m src.mcp_server。
5. 如何安装依赖？
6. 使用 uv pip install . 或 pip install .。

使用教程

使用依赖

1. 安装 uv（如果尚未安装）： shell pip install uv

安装教程

1. 克隆仓库： shell git clone https://github.com/Gitreceiver/TAMA-MCP cd TAMA-MCP
2. 创建并激活虚拟环境（推荐Python 3.12）： ```shell uv venv -p 3.12

# Windows ..venv\Scripts\activate

# macOS/Linux source .venv/bin/activate 3. **安装依赖和项目**：shell uv pip install . `` （或使用pip install .`）

调试方式

1. 列出任务： shell tama list tama list --status pending --priority high
2. 显示任务详情： shell tama show 1 tama show 1.2
3. 添加任务/子任务： shell tama add "Implement user authentication" --desc "Handle login and sessions" --priority high tama add "Create login API endpoint" --parent 1 --desc "Needs JWT handling"
4. 设置任务状态： shell tama status 1 done tama status 1.2 in-progress
5. 删除任务/子任务： shell tama remove 2 tama remove 1.3
6. 查找下一个任务： shell tama next
7. 解析PRD： shell tama prd path/to/your/document.txt
8. 扩展任务： shell tama expand 1
9. 检查依赖： shell tama deps
10. 生成报告： shell tama report markdown tama report mermaid tama report markdown --output report.md
11. 生成占位文件： shell tama gen-file 1 tama gen-file 2 --output-dir src/generated

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。