t-rush-mcp

---

t-rush-mcp を使う理由

AI コーディングエージェントはバグの修正が得意ですが、任せきりにすると、何に取り組むべきかを判断するのに苦労することがよくあります。t-rush-mcp は、標準の MCP ツールを通じてコードベースの技術的負債を AI に直接公開し、このギャップを埋めます。

エージェントは、プロジェクト内の未解決の TODO を検索したり、キーワードで絞り込んだり、古い負債を優先したりできるようになります。また、問題の解決に成功すると、個人の t-rush 完了連続記録を伸ばすこともできます。

💻 TODO を手動で修正したいですか？

t-rush CLI を使って、自分の TODO をスピードランで片付けましょう！バグを選び、タイマーを開始してコードを修正し、自分で大記録を築きましょう。

---

機能

• find_todos：未解決の TODO/FIXME コメントをすべてエージェントに渡し、エージェントが経過時間や深刻度に基づいてネイティブに順位付けできるようにします。
• search_todos：エージェントが既存のコメントをあいまい検索し、特定のタスクを見つけられるようにします。
• resolve_todo：コメントがファイルから削除されたことを確認し、t-rush の連続記録を自動的に伸ばします。
• scan_todos_raw：リポジトリ内の技術的負債すべてを、順位付けせずに生のリストとして返します。
• get_streak_status：ユーザーの現在の連続記録と統計情報をエージェントに公開します。
• aggregate_debt：複数のローカルリポジトリにまたがる負債の合計を要約します。

---

インストールと設定

1. npm 経由（グローバルインストール）

npm を使って、MCP サーバーをマシンにグローバルインストールできます。

npm install -g @devds1989/t-rush-mcp

2. 手動設定

このサーバーをクライアントの設定ファイル（例：claude_desktop_config.json）に手動で追加するには：

{
  "mcpServers": {
    "t-rush": {
      "command": "npx",
      "args": ["-y", "@devds1989/t-rush-mcp"],
      "eager": true
    }
  }
}

または、npx 経由で直接テストできます。

npx -y @devds1989/t-rush-mcp

3. Claude Code

このサーバーを Anthropic の Claude Code CLI に直接追加するには：

claude mcp add t-rush -- npx -y @devds1989/t-rush-mcp

要件： Node.js 18+

---

仕組み

t-rush-mcp は、共有の @devds1989/trush-core ロジックを使用し、t-rush CLI とまったく同じパーサーでコードベースをスキャンします。AI エージェントが行った連続記録の更新や履歴の変更は、ローカルの ~/.t-rush/data.json データベースと即座に同期されます。

AI エージェントが TODO を解決すると、連続記録が伸びます。チームワークですね！

---

対応言語

t-rush は、一般的なすべてのコメント形式で TODO と FIXME を検出します。

形式	言語
//	JavaScript、TypeScript、Go、Rust、C、C++、Java、Kotlin、Swift、Dart
#	Python、Ruby、Shell、YAML、R、Perl、Elixir、Crystal
--	SQL、Lua、Haskell、Ada
%	Erlang、LaTeX
;	Lisp、Clojure、Assembly
*	/* */ ブロックコメント内

---

コントリビューション

コントリビューションを歓迎します。大規模な PR を提出する前に、Issue を作成してください。

git clone https://github.com/DevDs1989/trush-mcp
cd trush-mcp
npm install
npm run build

---

ライセンス

MIT © Dev