# t-rush-mcp [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/DevDs1989/trush-mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 278  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/t-rush-mcp

## Description
MCP server for t-rush. Exposes TODO/FIXME scanning and streak tracking to AI agents.

## Tools
Capabilities this server exposes over MCP:

- **find_todos** — 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.
- **resolve_todo** — Mark a TODO as resolved, verifies it's gone from the file, and increments the streak.
- **scan_todos_raw** — Internal/manual use: returns the full unranked list of TODOs in a repo.
- **search_todos** — 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.
- **get_streak_status** — Get the current streak and stats data from the shared local store.
- **aggregate_debt** — Aggregate debt and streak views across multiple local repositories.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What t-rush-mcp MCP server does

The t-rush-mcp MCP server exposes technical-debt workflows to MCP-compatible coding assistants. It identifies TODO, FIXME, and BUG comments in a repository, provides prioritization based on age and severity, and supports searching for a particular task by intent rather than only by exact text.

The server also connects task completion to t-rush streak tracking. When a TODO is resolved, the server checks that the comment is no longer present in its file before updating the streak. Current streak and statistics are available through a separate tool. For teams or developers working across projects, debt and streak information can be aggregated from multiple local repositories.

Supported comment forms cover common languages and syntax styles, including slash comments, hash comments, SQL-style double dashes, percent comments, semicolon comments, and block-comment asterisks. The listed language coverage includes JavaScript, TypeScript, Go, Rust, Python, Ruby, Shell, SQL, Lua, Java, Kotlin, Swift, Dart, and several others.

## How it works

The t-rush-mcp MCP server uses the shared `@devds1989/trush-core` logic, so repository scanning follows the same parsers used by the t-rush CLI. Streak changes and history updates are synchronized with the local `~/.t-rush/data.json` store.

`find_todos` returns open technical-debt comments for prioritization. `scan_todos_raw` provides the complete unranked result for manual or internal use. `search_todos` performs a fuzzy search across the codebase and is intended for locating a specific TODO, FIXME, or BUG. `resolve_todo` verifies removal from the source file and increments the streak. `get_streak_status` reads current streak data, while `aggregate_debt` combines debt and streak views across local repositories.

A workflow using `find_todos` should treat its results as a planning queue rather than immediately presenting every item. The supplied operating guidance calls for creating one markdown plan artifact and requesting user feedback before making changes.

## Setup and configuration

Install the package globally with npm, or run it directly without a global installation:

```bash
npx -y @devds1989/t-rush-mcp
```

For a client configuration, register `npx` as the command and pass `-y` followed by `@devds1989/t-rush-mcp` as the arguments. The README gives this configuration for Claude Desktop and also documents adding the same command through Claude Code. Node.js 18 or later is required.

No API key or external service credential is described. Repository data and streak history are handled through local files, including the shared t-rush data store.

The project is released under the MIT license. Its npm package is `@devds1989/t-rush-mcp`; the related `t-rush` CLI is a separate project for manual technical-debt work and is not required as the MCP server command.

_Full upstream README: https://allmcps.com/mcp/t-rush-mcp/readme_