MCP Catalogs
首页

trueline-mcp

by rjkaes·17·综合分 43

MCP 插件为 AI 编码助手提供哈希验证的文件编辑和定向读取,减少令牌使用并防止静默损坏。

developer-toolsai-llmfile-system
4
Forks
1
活跃 Issue
1 个月前
最近提交
2 天前
收录于

概述

trueline-mcp 是一个模型上下文协议 (MCP) 服务器,旨在优化 AI 编码助手与文件的交互方式。它提供六个 MCP 工具,实现定向读取(仅获取需要的行范围)、紧凑编辑(使用内容哈希而非回显旧文本)和语义变更审查(基于 AST 的摘要)。该服务器拦截内置的编辑调用,将大文件读取重定向到其高效工具,并阻止未经验证的编辑,防止文件意外更改时的静默损坏。

试试问 AI

装完之后,这里有 5 个你可以让 AI 做的事:

:通过仅读取必要的行范围来减少处理大型源代码文件时的令牌使用
:防止 AI 代理编辑已并发更改的文件时发生代码静默损坏
:通过批量编辑和减少上下文窗口开销来提高多文件编辑会话的效率
:trueline-mcp 支持哪些平台?
:trueline-mcp 如何防止文件静默损坏?

什么时候选它

在使用大型代码库时,如果减少令牌使用和防止文件静默损坏是优先事项,请选择 trueline-mcp。

什么时候不要选它

如果您主要处理 3KB 以下的小文件(内置工具已经足够),或者您的 AI 平台不支持 MCP 钩子,请不要选择 trueline-mcp。

此 server 暴露的工具

从 README 抽取出 6 个工具
  • trueline_outline

    Returns an AST-based structural outline of any file showing functions, classes, declarations, and their line ranges.

  • trueline_read

    Reads specific line ranges from files to minimize token usage.

  • trueline_search

    Finds lines by literal string or regex and returns them with edit-ready references.

  • trueline_edit

    Performs compact and verified edits using line-range references and content hashes instead of echoing back entire blocks.

  • trueline_changes

    Provides an AST-based summary of structural changes compared to a git ref.

  • trueline_verify

    Checks whether held content references are still valid without re-reading the file.

可对比工具

vscode-hashline-edit-tool

安装

安装

**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 讨论

开发者社区最近的相关讨论。

trueline-mcp 对比

GitHub →

最后更新于 · 由 README + GitHub 公开数据自动生成。