Hashfile MCP — MCP-сервер для Claude Code: правка файлов по хешам
Сервер для правки файлов по содержимому строк, а не по номерам, и для контроля доступа агента к секретам и lock-файлам.
Открыть на GitHubЧто делает Hashfile MCP
Hashfile MCP решает старую боль: агент говорит «замени строку 42», а файл уже сдвинулся на три строки вниз. Здесь каждая строка при чтении получает короткий хеш, и операция правки ссылается на содержимое, а не на позицию. Сервер сам находит строку, даже если она переехала, а хеш файла не даёт применить правку к устаревшей версии. Операции replace, insert_after, insert_before и delete можно собрать в одну атомарную пачку.
Внутри девять инструментов: три для правки по хешам (read_text_file, edit_text_file, write_text_file) и шесть обычных файловых (list_directory, directory_tree, create_directory, move_file, write_file, read_multiple_files). Доступ ограничивается через frontmatter в AGENTS.md: forbidden закрывает путь целиком, read_only разрешает чтение, но не запись, ignore прячет каталог от агента. Файл можно положить в любом месте дерева, побеждает ближайший. Паттерны .gitignore сервер тоже учитывает, а правила из AGENTS.md имеют приоритет.
Сборка из исходников: cargo build --release, бинарник окажется в target/release/hashfile-mcp. Без установленного Rust собрать не получится, а путь к бинарнику прописывается в конфиге MCP-клиента вручную. Зависимостей у сервера нет.
Какие задачи решает
- править файл, который сдвинулся после чтения, и не попасть в чужую строку
- закрыть агенту доступ к
.envи ключам - запретить запись в lock-файлы и схемы, оставив чтение
- спрятать
node_modulesи сборку из контекста агента - применить несколько правок одним действием
Примеры запросов агенту
- Прочитай
src/main.rsи замени строку с функциейmainна новую версию - Добавь в
AGENTS.mdзапрет наsecrets/**и**/*.env - Покажи дерево проекта без
node_modulesиtarget
Как установить Hashfile MCP
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Hashfile MCP
Как установить Hashfile MCP в Claude Code?
Соберите бинарник командой cargo build --release, он появится в target/release/hashfile-mcp. Затем добавьте сервер в конфиг MCP-клиента с ключом hashfile и укажите этот путь в поле command.
Что делает Hashfile MCP?
Даёт агенту девять инструментов для работы с файлами: правку по хешам строк и обычные файловые операции. Плюс ограничивает доступ через frontmatter в AGENTS.md и паттерны .gitignore.
Чем правка по хешам отличается от правки по номерам строк?
Операция ссылается на содержимое строки, а не на её номер. Если строки выше добавились или удалились, сервер найдёт нужное место сам, а хеш файла покажет, что содержимое изменилось после чтения.
