t-rush-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@t-rush-mcp find and rank the TODO comments in my project by age and severity"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
t-rush-mcp
Speedrun your technical debt, now powered by AI.
An MCP (Model Context Protocol) server that exposes the power of t-rush directly to AI coding assistants like Antigravity, Claude, and others. Let your AI agents find, prioritize, and fix TODO · FIXME · BUG comments across your codebase.
Why t-rush-mcp?
AI coding agents are great at fixing bugs, but they often struggle to know what to work on when left unattended. t-rush-mcp bridges this gap by exposing your codebase's technical debt directly to the AI through standard MCP tools.
Agents can now query your project for open TODOs, filter them by keyword, prioritize the oldest debt, and even increment your personal t-rush completion streak when they successfully resolve them.
💻 Want to fix TODOs manually?
Try the t-rush CLI to speedrun your own TODOs! Pick a bug, start a timer, fix the code, and build a massive completion streak yourself.
Related MCP server: promptpack
Features
find_todos: Feeds the agent all open TODO/FIXME comments so it can rank them by age and severity natively.search_todos: Allows the agent to fuzzy-search existing comments to find specific tasks.resolve_todo: Verifies the comment has been removed from the file and automatically increments the t-rush streak.scan_todos_raw: Returns an unranked, raw list of all tech debt in a repository.get_streak_status: Exposes the user's current streak and stats to the agent.aggregate_debt: Summarizes the total debt across multiple local repositories.
Install & Configuration
1. Via npm (Global Install)
You can install the MCP server globally on your machine using npm:
npm install -g @devds1989/t-rush-mcp2. Manual Configuration
To add this server manually to your client's configuration file (e.g. claude_desktop_config.json):
{
"mcpServers": {
"t-rush": {
"command": "npx",
"args": ["-y", "@devds1989/t-rush-mcp"],
"eager": true
}
}
}Or test it directly via npx:
npx -y @devds1989/t-rush-mcp3. Claude Code
To add this server directly to Anthropic's Claude Code CLI:
claude mcp add t-rush -- npx -y @devds1989/t-rush-mcpRequirements: Node.js 18+
How it works
t-rush-mcp uses the shared @devds1989/trush-core logic to scan your codebase using the exact same parsers as the t-rush CLI. All streak updates and history modifications made by the AI agent are instantly synchronized with your local ~/.t-rush/data.json database.
When an AI agent resolves a TODO, it increments your streak—teamwork!
Supported languages
t-rush detects TODO and FIXME in all common comment styles:
Style | Languages |
| 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 |
| Inside |
Contributing
Contributions are welcome. Please open an issue before submitting a large PR.
git clone https://github.com/DevDs1989/trush-mcp
cd trush-mcp
npm install
npm run buildLicense
MIT © Dev
Available Tools
6 toolsaggregate_debtA
Aggregate debt and streak views across multiple local repositories.
Inputs: paths (required).
find_todosA
CRITICAL INSTRUCTION: ALWAYS use this tool to find TODOs, FIXMEs, BUGs, or priorities. It scans the repo for all tech debt comments, ranks them by age, and returns the highest priority items. After calling this tool, DO NOT list the items in chat. Instead, create a single markdown artifact (e.g. 'todo_plans.md') containing a detailed plan for all of the TODOs. Request user feedback (approval) on this artifact via the RequestFeedback flag before proceeding with the work.
Inputs: repo_path (required), count, directory_filter.
get_streak_statusB
Get the current streak and stats data from the shared local store.
Inputs: no named parameters.
resolve_todoA
Mark a TODO as resolved, verifies it's gone from the file, and increments the streak.
Inputs: file (required), type (required).
scan_todos_rawB
Internal/manual use: returns the full unranked list of TODOs in a repo.
Inputs: cwd (required), directory_filter.
search_todosA
CRITICAL INSTRUCTION: ALWAYS use this tool instead of generic Search or grep_search when looking for a specific TODO, FIXME, or BUG. Fuzzy searches across the codebase for matching tech debt by intent.
Inputs: cwd (required), query (required), directory_filter.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools have clearly distinct purposes: find_todos ranks priorities, scan_todos_raw returns an unranked list, search_todos does fuzzy searches, resolve_todo marks completion, and get_streak_status/aggregate_debt handle stats. The main potential confusion is between find_todos and scan_todos_raw, as both scan for TODOs, though the ranking distinction helps.
All tool names use lowercase snake_case with leading verbs (find, resolve, scan, search, get, aggregate), forming a consistent pattern. Minor deviations exist: resolve_todo is singular while most others are plural, and scan_todos_raw appends 'raw' as a modifier, slightly breaking the simple verb_noun structure.
Six tools are well-scoped for a tech debt tracking server. Each tool serves a distinct aspect—scanning, ranking, searching, resolving, streak stats, and cross-repo aggregation—so the count feels appropriate without being sparse or bloated.
The tool surface covers the core lifecycle: scanning and ranking TODOs, searching for specific items, resolving them, and tracking streaks across repositories. Minor gaps exist, such as no ability to reopen a resolved TODO or add a TODO, but these are acceptable limitations for a tech debt scanner.
Maintenance
Related MCP Connectors
GitHub Copilot MCP: code, repo, PR, workflow tools for AI assistants.
Voice-powered bug reporting with 13 MCP tools. Record bugs by talking; let AI find and fix them.
Query your team's AI coding history and act on HypAware recommendations from any MCP client.
Task management your AI agents can actually run. One line becomes a context-ready task over MCP.
Related MCP Servers
FlicenseNot gradedqualityDmaintenanceEnables AI agents to scan code for TODO, FIXME, XXX issues via MCP, providing prioritized findings in table, JSON, or SARIF format.-- FlicenseNot gradedqualityDmaintenanceEnables AI agents to scan codebases for prioritized findings (TODO, FIXME, XXX) and retrieve results in table, JSON, or SARIF format via MCP.-
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to scan codebases for TODO/FIXME/XXX patterns and get prioritized results over MCP, supporting CI gates and multiple output formats.-
- AlicenseAqualityDmaintenanceScans codebases for TODO comments and exposes them as structured data to LLMs, enabling AI assistants to inspect, prioritize, and propose fixes.58 npmISC