trueline-mcp
by rjkaes·★ 17·综合分 43
MCP 插件为 AI 编码助手提供哈希验证的文件编辑和定向读取,减少令牌使用并防止静默损坏。
概述
trueline-mcp 是一个模型上下文协议 (MCP) 服务器,旨在优化 AI 编码助手与文件的交互方式。它提供六个 MCP 工具,实现定向读取(仅获取需要的行范围)、紧凑编辑(使用内容哈希而非回显旧文本)和语义变更审查(基于 AST 的摘要)。该服务器拦截内置的编辑调用,将大文件读取重定向到其高效工具,并阻止未经验证的编辑,防止文件意外更改时的静默损坏。
试试问 AI
装完之后,这里有 5 个你可以让 AI 做的事:
什么时候选它
在使用大型代码库时,如果减少令牌使用和防止文件静默损坏是优先事项,请选择 trueline-mcp。
什么时候不要选它
如果您主要处理 3KB 以下的小文件(内置工具已经足够),或者您的 AI 平台不支持 MCP 钩子,请不要选择 trueline-mcp。
此 server 暴露的工具
从 README 抽取出 6 个工具trueline_outlineReturns an AST-based structural outline of any file showing functions, classes, declarations, and their line ranges.
trueline_readReads specific line ranges from files to minimize token usage.
trueline_searchFinds lines by literal string or regex and returns them with edit-ready references.
trueline_editPerforms compact and verified edits using line-range references and content hashes instead of echoing back entire blocks.
trueline_changesProvides an AST-based summary of structural changes compared to a git ref.
trueline_verifyChecks whether held content references are still valid without re-reading the file.
可对比工具
安装
安装
**Claude Code(推荐;自动挂钩):**
/plugin marketplace add rjkaes/trueline-mcp
/plugin install trueline-mcp@trueline-mcp**其他平台(Gemini CLI、VS Code Copilot、OpenCode、Codex CLI):** 请参阅 [INSTALL.md](https://github.com/rjkaes/trueline-mcp/blob/main/INSTALL.md) 了解平台特定的设置说明。
**CLI(无 MCP):** 对于使用 shell 命令而非 MCP 的代理,请使用 npm i -g trueline-mcp 全局安装,并将 configs/cli/instructions.md 添加到代理的系统提示中。
FAQ
- trueline-mcp 支持哪些平台?
- 它支持 Claude Code、Gemini CLI、VS Code Copilot、OpenCode 和 Codex CLI,根据平台功能提供不同级别的功能。
- trueline-mcp 如何防止文件静默损坏?
- 它使用内容哈希验证 - 每次读取操作都包含哈希值,而编辑必须返回这些哈希。如果文件自读取后已更改,或者代理产生幻觉内容,编辑将被拒绝。
Hacker News 讨论
开发者社区最近的相关讨论。
- 帖子 by rjkaes · 2026-03-05
trueline-mcp 对比
最后更新于 · 由 README + GitHub 公开数据自动生成。