ZenTao MCP

禅道の研究開発コラボレーションのためのMCPサービス。ディレクター視点の要件分解、実行計画、作業量配分の提案、および開発者視点のタスクとバグのワークフローをカバーします。

現在のステータス

現在はPhase 1開発段階で、接続診断と読み取り専用クエリツールを提供しています：

• diagnose_connection

• list_projects

• list_executions

• list_products

• list_stories

• list_tasks

• list_execution_tasks

• list_my_tasks

• list_user_tasks

• list_bugs

• list_my_bugs

• list_user_bugs

• list_users

• get_task

• get_story

• get_bug

list_stories と list_bugs は禅道の製品IDを必要とし、それぞれ製品下の要件とバグにアクセスします。エージェントはまず list_users を呼び出し、返された account を使用して list_user_tasks または list_user_bugs を呼び出すことができ、ユーザーが手動でユーザー名を入力する必要はありません。

書き込みツールは現在デフォルトでプランのみを生成し、リクエストを実行しません。明示的に confirm: true を渡した場合のみ書き込みリクエストが送信されます：

• create_task

• assign_task

• start_task

• finish_task

• complete_task（「1554を完了としてマーク」のような自然言語の指示に適しています）

• resolve_bug

テストや通常の呼び出しでは confirm: true を使用しないでください。

Related MCP server: zentao-mcp-server

ローカル実行

Copy-Item .env.example .env
npm install
npm run check
npm test
npm run build
npm start

デフォルトではユーザーディレクトリの設定ファイルで禅道接続を構成します：~/.zentao-mcp/config.json（Windowsでは %USERPROFILE%\\.zentao-mcp\\config.json）。例：

{
  "baseUrl": "https://your-zentao.example.com",
  "apiPath": "/zentao/api.php/v1",
  "token": "your-token",
  "timeoutMs": 10000
}

環境変数 ZENTAO_CONFIG_FILE で設定ファイルのパスを指定できます。ZENTAO_* 変数は高度な上書き/補足手段としてのみ使用します。実際の認証情報をリポジトリに書き込まないでください。