TAMA MCP

🚀 Tama-MCP

Tama-MCPは、AI技術を活用したタスク管理CLIツールで、MCPサーバ機能も備えています。このツールを使えば、タスクの追跡、依存関係の管理、レポートの生成が簡単に行えます。

連絡先（微信）：

🚀 クイックスタート

Tama-MCPを使って、タスク管理を始めましょう。以下は基本的なコマンドの使用例です。

新しいタスクを作成する

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または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 的完成"

高度な使用法

レポートを生成する

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ファイルをご覧ください。