TAMA-MCP

Tama - AI 驱动的任务管理 CLI ✨

Tama 是一个命令行界面（CLI）工具，专为任务管理设计，并集成了 AI 功能，用于任务生成和扩展。它利用 AI（通过 DeepSeek 模型的 OpenAI 兼容 API 配置）来解析产品需求文档（PRD），并将复杂任务分解为可管理的子任务。

功能

标准任务管理： 添加、列出、显示详情、更新状态、删除任务和子任务，并跟踪依赖关系。

依赖管理： 添加、删除和跟踪任务依赖关系，自动检测循环依赖。

AI 驱动的 PRD 解析： (tama prd <filepath>) 从 .txt 或 .prd 文件自动生成结构化任务列表。

AI 驱动的任务扩展： (tama expand <task_id>) 使用 AI 将高级任务分解为详细的子任务。

依赖检查： (tama deps) 检测并可视化任务中的循环依赖。

报告生成： (tama report [markdown|mermaid]) 生成 Markdown 表格格式的任务报告或 Mermaid 依赖图。

代码占位符生成： (tama gen-file <task_id>) 根据任务详情创建占位代码文件。

下一个任务建议： (tama next) 根据状态和依赖关系识别下一个可执行任务。

丰富的 CLI 输出： 使用 rich 库生成格式化和美观的控制台输出（例如表格、面板）。

安装与设置

克隆仓库：

创建并激活虚拟环境（推荐使用 Python 3.12）：

安装依赖项和项目： （需要 uv - 如果没有安装，请使用 pip install uv 安装）

（或者，使用 pip：pip install .）

配置 ⚙️

Tama 需要为其 AI 功能配置 API 密钥。

添加你的 DeepSeek API 密钥：

（参见 .env.example 作为模板）

应用程序使用 src/config/settings.py 中定义的设置，该文件从 .env 文件中加载变量。

使用 🚀

Tama 命令在激活的虚拟环境中通过终端运行。 核心命令：

列出任务：

任务列表现在包含状态和优先级的表情符号指示器，并以清晰的 Markdown 表格格式显示依赖关系。

显示任务详情：

添加任务/子任务：

设置任务状态：

（有效状态：pending, in-progress, done, deferred, blocked, review）

删除任务/子任务：

删除任务时，所有依赖任务将自动更新，并通知你受影响的依赖关系。

管理依赖关系：

查找下一个任务：

AI 命令：

解析 PRD： （输入文件必须是 .txt 或 .prd）

扩展任务： （提供主任务 ID）

实用命令：

检查依赖关系：

生成报告：

生成占位文件：

Shell 自动补全：

可以通过以下命令获取设置 shell 自动补全的说明：

（注意：根据你的 shell 和操作系统设置，可能需要管理员权限）

开发 🔧

如果修改了源代码，请记得重新安装包以使更改在 CLI 中生效：

MCP 服务器使用

Tama 可以作为 MCP（Model Context Protocol）服务器使用，允许其他应用程序以编程方式与其交互。MCP 服务器提供以下工具：

list_tasks: 列出所有任务，支持可选的状态/优先级过滤，并以 Markdown 格式返回

show_task: 显示特定任务的详细信息

set_status: 更新任务状态并自动传播

next_task: 查找下一个可执行任务

add_task: 创建新的主任务

add_subtask: 创建新的子任务

remove_item: 删除任务或子任务并清理依赖关系

add_dependency: 添加任务之间的依赖关系

remove_dependency: 移除任务之间的依赖关系

check_dependencies: 检查循环依赖

启动服务器：

在你的 MCP 客户端中（cline, cursor, claude）：

这将启动 Tama MCP 服务器，提供以下工具：

get_task: 通过 ID 查找并返回任务或子任务。

find_next_task: 查找下一个可执行任务。

set_task_status: 设置任务或子任务的状态。

add_task: 添加新的主任务。

add_subtask: 添加新的子任务。

remove_item: 删除子任务或主任务。

add_dependency: 添加任务之间的依赖关系

remove_dependency: 移除任务之间的依赖关系

get_tasks_table_report: 生成表示任务结构的 Markdown 表格。

许可证

MIT 许可证本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

=======

AI 驱动的任务管理 CLI 与 MCP 服务器

通过微信联系我：