🚀 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 文件获取详细信息。