Hashfile MCP

MCP运维云端

提供方 mrorigo

运维云端 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaude

Hashfile MCP Server 是一个提供精细文件编辑和访问控制的模型上下文协议服务器,适用于需要精确控制AI文件操作的场景。

一句话选型结论

按资料字段整理

Hashfile MCP 属于运维云端类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式未标注 鉴权无需鉴权 部署方式本地部署
GitHub 星标 3 仓库热度,无公开仓库时显示未标注
工具数 9 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量9暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

文件编辑Rust本地部署访问控制AI工具内容锚定文件系统管理

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 9 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 9 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Hashfile MCP当前 9 未标注 本地部署 无 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方mrorigo上游标注的维护方 mrorigo
分类运维云端本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.9 KB
来自项目仓库与上游目录的原文,未做删改

哈希文件MCP服务器

AI文件操作的精细控制 --一个模型上下文协议(MCP)服务器,它为您提供了对文件编辑的精确控制和对文件访问的铁腕控制。

为什么选择哈希文件MCP?

🎯 手术文件编辑

与文件更改时中断的传统基于行号的编辑不同,Hashfile使用 内容锚定操作:

  • 哈希锚线:每一行都标记有内容哈希值——edits的目标是 正确的内容,而不仅仅是正确的行号
  • 模糊匹配:即使在插入/删除后,也会自动查找移动的行
  • 碰撞检测:文件级验证可防止编辑过时内容
  • 多操作编辑:在单个原子操作中应用多个精确更改

🔒 铁壳门禁

完全控制AI代理可以接触的内容 AGENTS.md头版:

  • forbidden:阻止访问机密、凭据、敏感数据
  • read_only:允许读取架构、配置、锁定文件——防止修改
  • ignore:从AI上下文中隐藏生成的代码、依赖关系、构建工件
  • 分层发现:将AGENTS.md放在树中的任何位置——最近的文件获胜
  • 球形图案:使用通配符微调访问(secrets/**, **/*.env)

📖 完整的AGENTS.md文档 | 📋 建议书规范

🛠️ 插入式文件系统兼容性

所有标准MCP文件系统工具包括:

  • list_directory --浏览 [FILE]/[DIR] 前缀
  • directory_tree --紧凑的树视图(令牌效率比JSON高10倍)
  • create_directory --递归目录创建
  • move_file --重命名/移动文件和目录
  • write_file --原始UTF-8写入(非哈希行)
  • read_multiple_files --一次性批量读取

功能概览

特点 优点
哈希锚定编辑 编辑在文件更改后仍然有效——不再出现“第42行不匹配”错误
内容验证 6字符文件哈希防止竞争条件
AGENTS.md支持 声明式访问控制——保护秘密、锁定模式、隐藏噪音
模糊线匹配 即使在插入/删除后也能找到正确的行
9 MCP工具 3个哈希行工具+6个标准文件系统工具
零依赖 纯Rust,编译为单个二进制文件

安装```bash

cargo build --release


二进制文件将位于 `target/release/hashfile-mcp`.

## 快速开始

### 1.配置您的MCP客户端

添加到Claude Desktop或MCP客户端配置:```json
{
"mcpServers": {
"hashfile": {
"command": "/path/to/hashfile-mcp/target/release/hashfile-mcp"
}
}
}

2.(可选)添加访问控制

创建 AGENTS.md 在项目根目录中:```markdown

forbidden:
- "secrets/"
- "
/.env"
- ".git/
*"

read_only:
- "package-lock.json"
- "Cargo.lock"
- "schema.sql"

ignore:
- "node_modules/"
- "target/
"
- "*/.generated.ts"


Project Instructions

Your custom instructions for AI agents here...


### 3.开始编辑

AI现在可以:

- ✅ 以哈希锚定精度读取和编辑源文件
- ✅ 浏览目录并创建新文件
- ❌ 不能触碰你的秘密或 `.env` 文件
- ❌ 无法修改锁文件或架构
- 🙈 不会看到 `node_modules` 或构建工件

## Hashline的工作原理

### 问题

文件更改时,传统行号编辑失败:```
Agent: "Replace line 42"
Reality: Someone inserted 3 lines at the top
Result: Wrong line replaced! 💥

解决方案

带有哈希验证的内容锚定编辑:

  1. 阅读:每行都有一个哈希标签→ 42:a3|const x = 1;
  2. 编辑:操作参考内容,而不仅仅是职位→ "anchor": "42:a3"
  3. 应用:服务器逐行查找哈希值,即使它移动到第45行
  4. 验证:文件哈希必须匹配--检测读取后内容是否更改

可靠性特征

  • 文件级别验证:6个字符的哈希可防止编辑过时的内容
  • 线路水平锚定:2个字符的哈希标识特定行
  • 模糊匹配:如果行号更改,则搜索唯一的哈希匹配
  • 冲突检测:如果内容不一致,请清除错误

核心工具

Hashline工具(精确编辑)

read_text_file

返回带有哈希标记行的内容,以便进行可靠的编辑:```
1:a3|import { useState } from 'react';
2:7f|
3:2c|export function Counter() {


hashline_version: 1
total_lines: 3
file_hash: 8f3a9b


#### `edit_text_file`

应用哈希锚定操作:```json
{
"path": "/path/to/file.ts",
"file_hash": "8f3a9b",
"operations": [
{
"op_type": "replace",
"anchor": "3:2c",
"content": "export function Counter({ initial = 0 }) {"
}
]
}

操作类型: replace, insert_after, insert_before, delete

write_text_file

写入内容并返回哈希行标记的验证

文件系统工具(标准操作)

`list_directory````

[DIR] src
[DIR] tests
[FILE] README.md
[FILE] Cargo.toml


#### `directory_tree````
src/
├── agents.rs
├── config.rs
├── filesystem.rs
├── hashline.rs
├── main.rs
└── tools.rs

支持 exclude_patterns 用于过滤(例如。, ["**/node_modules/**", "**/.git/**"])

create_directory, move_file, write_file, read_multiple_files

具有AGENTS.md强制的标准文件系统操作

AGENTS.md访问控制

约束类型

约束 效果 用例
forbidden 阻止所有访问 机密、凭据、私钥
read_only 允许读取、阻止写入 模式、锁定文件、生成配置
ignore 在AI环境中隐藏 依赖关系、构建伪影、噪声

自动.gitignore支持

哈希文件MCP自动遵守 .gitignore 项目中的文件:

  • 分层的:从目标文件中查找所有文件 .gitignore 文件
  • 标准语法:支持标准 .gitignore 模式(基名、目录、路径)
  • 与AGENTS.md结合:两个来源的模式被合并
  • 零配置:与现有项目一起开箱即用

图案转换:```

.gitignore

.log → /.log
node_modules/ → node_modules/**
build/output → build/output


**优先:** 代理商.md `ignore` 模式优先于 `.gitignore`.

### 示例:保护Monorepo```yaml
---
forbidden:
- "**/secrets/**"
- "**/*.key"
- "**/*.pem"
- ".env*"

read_only:
- "**/package-lock.json"
- "**/Cargo.lock"
- "db/schema.sql"

ignore:
- "**/node_modules/**"
- "**/target/**"
- "**/.next/**"
- "**/*.generated.*"
---

分级控制

地方 AGENTS.md 任何级别的文件:```
/project/AGENTS.md ← Global rules
/project/backend/AGENTS.md ← Backend-specific rules (overrides global)
/project/frontend/AGENTS.md ← Frontend-specific rules


这 **最近的** `AGENTS.md` 在目录层次结构中应用。

## 发展

### 运行测试```bash
cargo test

项目结构```

src/
├── main.rs # MCP server setup
├── tools.rs # Tool definitions (9 tools)
├── hashline.rs # Hash-anchored editing logic
├── filesystem.rs # Standard filesystem operations
├── agents.rs # AGENTS.md frontmatter parsing
├── config.rs # Configuration (future: tool enablement)
└── roots.rs # Root path management (future)
```

技术细节

  • 语言:《铁锈》(2021年版)
  • MCP-SDK:人民币0.15.0元
  • 线路散列:FNV-1a(2个十六进制字符,256个桶)
  • 文件哈希:FNV-1a(6个十六进制字符,16M桶)
  • 运输标准: stdio
  • 依赖项: rmcp, serde, serde_json, serde_yaml, globset, anyhow, fnv

路线图

  • []基于环境变量的工具启用(ENABLE_FILESYSTEM_TOOLS=true)
  • []精细工具控制(ENABLE_LIST_DIRECTORY=true等等)
  • []其他工具: get_file_info, search_files, list_directory_with_sizes
  • []配置的命令行参数支持

许可证

有关详细信息,请参阅LICENSE文件。

另见

  • 线束问题 -我在一个下午的时间里提高了15个LLMs的编码能力。只更换了安全带。-2026年2月25日
  • AGENTS.md提案 -代理访问控制的前端规范

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Hashfile MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Hashfile MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Hashfile MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Hashfile MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Hashfile MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Hashfile MCP 能提供哪些能力?

资料显示约 9 个工具;能力标签包括 访问控制、Rust、Claude。具体工具清单以官方文档为准。

Hashfile MCP 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Hashfile MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。