Octofs — MCP-сервер для Claude Code: что делает и как установить
Даёт ассистенту прямой доступ к файлам проекта и удалённым серверам по SSH. Помогает искать код, атомарно вносить правки и выполнять консольные команды.
claude mcp add octofs -- npx -y @muvon/octofsЧто делает Octofs
Octofs написан на Rust с использованием библиотек tokio и axum. Сервер открывает языковым моделям доступ к файловой системе: ассистент может обходить каталоги с учётом правил .gitignore, искать фрагменты кода с соседними строками и читать файлы частями. Для работы с внешними серверами поддерживаются адреса формата ssh://.
Внутри реализован строгий контроль правок. При изменении строк генерируются композитные идентификаторы N:hh, проверяющие хеш содержимого перед сохранением. Если файл успел измениться, сервер отклоняет операцию и отдаёт подсказки для смещения правок. В памяти сохраняется история до 10 шагов отмены на каждый файл.
Сборка из исходников требует Rust версии 1.95 или новее. Для повседневной работы компилятор не нужен: сервер можно запускать через npx с автоматической загрузкой бинарника.
Какие задачи решает
- Искать вхождения текста в коде с показом строк контекста
- Редактировать удалённые файлы через протокол SSH
- Вносить атомарные пакетные правки в один файл
- Предотвращать перезапись кода при конфликтах хешей строк
Примеры запросов агенту
- Найди все вызовы unwrap() в проекте и покажи контекст вокруг них
- Создай файл test.rs и добавь туда базовые модульные тесты
- Покажи структуру каталога по адресу ssh://user@server:22/var/www
Как установить Octofs
Командой платформы
claude mcp add octofs -- npx -y @muvon/octofsКомандой платформы
codex mcp add octofs -- npx -y @muvon/octofsФайл настроек
{
"mcpServers": {
"octofs": {
"command": "npx",
"args": [
"-y",
"@muvon/octofs"
]
}
}
}Файл настроек
{
"servers": {
"octofs": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@muvon/octofs"
]
}
}
}Командой платформы
gemini mcp add octofs npx -y @muvon/octofsПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Octofs
Как установить Octofs в Claude Code?
Выполните команду claude mcp add octofs -- npx -y @muvon/octofs. Пакет сам скачает нужный бинарный файл при первом запуске.
Что делает Octofs?
Сервер даёт модели инструменты для обзора директорий, чтения файлов, атомарного редактирования, запуска команд и работы по SSH.
Как Octofs защищает от конфликтов при редактировании?
Каждая строка получает хеш в формате N:hh. Если содержимое файла изменилось до применения правки, сервер прерывает запись и сообщает новые координаты строк.
