t-rush-mcp

---

为什么选择 t-rush-mcp？

AI 编码 Agent 很擅长修复错误，但在无人看管时，往往难以判断该处理什么问题。t-rush-mcp 通过标准 MCP 工具将代码库中的技术债直接提供给 AI，弥补了这一不足。

Agent 现在可以查询项目中的未解决 TODO，按关键字筛选，为最早出现的技术债确定优先级，甚至在成功解决问题后增加你个人的 t-rush 连续完成记录。

💻 想手动修复 TODO？

试试 t-rush CLI，快速清理自己的 TODO！挑选一个错误，启动计时器，修复代码，亲手累积大量连续完成记录。

---

功能

• find_todos：向 Agent 提供所有未解决的 TODO/FIXME 注释，让它原生地按存在时长和严重程度排序。
• search_todos：允许 Agent 模糊搜索现有注释，以查找特定任务。
• resolve_todo：验证注释是否已从文件中移除，并自动增加 t-rush 连续完成记录。
• scan_todos_raw：返回仓库中未经排序的全部技术债原始列表。
• get_streak_status：向 Agent 提供用户当前的连续记录和统计数据。
• 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 Agent 所做的所有连续记录更新和历史记录修改，都会立即与本地 ~/.t-rush/data.json 数据库同步。

当 AI Agent 解决一个 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