🚀 Tama-MCP
Tama-MCP 是一款由人工智能驱动的任务管理 CLI 工具，同时具备 MCP 服务器功能。它能够高效地进行任务跟踪、依赖关系管理，还能生成详细的报告，为任务管理提供强大支持。
联系我微信：
✨ 主要特性
- 任务管理：可轻松创建、查看、编辑和删除任务及子任务。
- 依赖关系处理：支持添加和删除任务之间的依赖关系，并能自动处理依赖冲突。
- 生成报告：能以 Markdown 或 Mermaid 图表格式输出任务结构报告。
- AI 驱动：支持从 PRD 文件解析需求并自动生成任务分解。
- MCP 服务器：提供 RESTful API，允许其他应用程序与 Tama-MCP 进行交互。
📦 安装指南
使用 pip 安装
uv pip install .
克隆仓库
git clone https://github.com/yourusername/TAMA-MCP.git
cd TAMA-MCP
uv pip install .
🚀 快速开始
创建新任务
tama add_task "完成项目文档"
添加子任务
tama add_subtask 1 --name "整理需求文档" --description "完成项目需求部分的编写"
设置任务状态
tama set_status 1 -s "已完成"
查看任务列表
tama list_tasks --status "未完成"
添加依赖关系
tama add_dependency 1 2 --description "任务 2 依赖于任务 1 的完成"
💻 使用示例
基础用法
# 创建新任务
tama add_task "完成项目文档"
# 添加子任务
tama add_subtask 1 --name "整理需求文档" --description "完成项目需求部分的编写"
# 设置任务状态
tama set_status 1 -s "已完成"
# 查看任务列表
tama list_tasks --status "未完成"
# 添加依赖关系
tama add_dependency 1 2 --description "任务 2 依赖于任务 1 的完成"
高级用法
生成报告
Markdown 格式
tama report markdown
Mermaid 图表
tama report mermaid
输出到文件
tama report markdown --output report.md
自动生成占位符文件
tama gen-file 1 --output-dir src/generated
📚 详细文档
MCP 服务器使用说明
Tama-MCP 可以作为 MCP 服务器运行，提供以下功能：
list_tasks：列出所有任务，支持状态或优先级过滤。show_task：显示特定任务的详细信息。set_status：更新任务状态并自动传播更改。next_task：找到下一个可执行的任务。add_task：创建新主任务。add_subtask：创建新子任务。remove_item：删除任务或子任务，清理依赖关系。add_dependency：添加任务之间的依赖关系。remove_dependency：移除任务之间的依赖关系。check_dependencies：检查循环依赖。
启动服务器
uv --directory /path/to/your/TAMA_MCP run python -m src.mcp_server
客户端配置（示例）
在您的 MCP 客户端中：
{
"mcpServers": {
"TAMA-MCP-Server": {
"command": "uv",
"args": [
"--directory",
"/path/to/your/TAMA_MCP",
"run",
"python",
"-m",
"src.mcp_server"
]
}
}
}
常见问题
如何解决依赖关系循环？
Tama-MCP 提供了 check_dependencies 命令来检测和处理循环依赖，确保任务执行顺序的合理性。
tama check_dependencies
如何生成 Mermaid 图表？
运行以下命令即可生成 Mermaid 格式的任务结构图：
tama report mermaid > diagram.md
贡献指南
欢迎贡献代码！请参考 GitHub 仓库 的 CONTRIBUTING 文件，了解如何参与开发。
📄 许可证
Tama-MCP 采用 MIT 许可证。查看 LICENSE 文件获取详细信息。