TAMA MCP

🚀 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 文件獲取詳細信息。