内容
<div align="center">
<img width="1160" alt="t-rush-mcp" src="./trush-mcp.png" />
# t-rush-mcp
**加速解决技术债务，现在由 AI 提供支持。**
一个 MCP（模型上下文协议）服务器，直接向 Antigravity、Claude 等 AI 编码助手暴露 t-rush 的能力。让您的 AI 代理查找、优先处理并修复代码库中 TODO · FIXME · BUG 注释。
[](https://www.npmjs.com/package/@devds1989/t-rush-mcp)
[](./LICENSE)
</div>
---
## 为什么选择 t-rush-mcp？
AI 编码代理在修复错误方面表现出色，但当无人看管时，它们往往难以确定 *该处理什么*。`t-rush-mcp` 通过标准 MCP 工具将代码库的技术债务直接暴露给 AI，从而弥合了这一差距。
代理现在可以查询项目中的开放 TODO，过滤关键词，优先处理最老的技术债务，甚至在成功解决它们时增加您的个人 t-rush 完成连胜。
---
## 功能
- **`find_todos`**：向代理提供所有开放的 TODO/FIXME 注释，以便其可以原生地按年龄和严重程度排序。
- **`search_todos`**：允许代理模糊搜索现有注释以查找特定任务。
- **`resolve_todo`**：验证注释是否已从文件中删除，并自动增加 t-rush 连胜。
- **`scan_todos_raw`**：返回存储库中所有技术债务的未排序、原始列表。
- **`get_streak_status`**：向代理公开用户的当前连胜和统计数据。
- **`aggregate_debt`**：汇总多个本地存储库的总债务。
---
## 安装与配置
### 1. 通过 npm（全局安装）
您可以使用 npm 在机器上全局安装 MCP 服务器：
```bash
npm install -g @devds1989/t-rush-mcp
```
### 2. 手动配置
要将此服务器手动添加到客户端配置文件（例如 `claude_desktop_config.json`）：
```json
{
"mcpServers": {
"t-rush": {
"command": "npx",
"args": ["-y", "@devds1989/t-rush-mcp"]
}
}
}
```
或直接通过 npx 测试：
```bash
npx -y @devds1989/t-rush-mcp
```
### 3. Claude 代码
要将此服务器直接添加到 Anthropic 的 Claude Code CLI：
```bash
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 之前打开问题。
```bash
git clone https://github.com/DevDs1989/trush-mcp
cd trush-mcp
npm install
npm run build
```
---
## 许可证
[MIT](./LICENSE) Dev
