# Octofs

Даёт ассистенту прямой доступ к файлам проекта и удалённым серверам по SSH. Помогает искать код, атомарно вносить правки и выполнять консольные команды.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 18
- Автор: Muvon
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Muvon/octofs
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/octofs

## Что делает

Octofs написан на Rust с использованием библиотек `tokio` и `axum`. Сервер открывает языковым моделям доступ к файловой системе: ассистент может обходить каталоги с учётом правил `.gitignore`, искать фрагменты кода с соседними строками и читать файлы частями. Для работы с внешними серверами поддерживаются адреса формата `ssh://`.

Внутри реализован строгий контроль правок. При изменении строк генерируются композитные идентификаторы `N:hh`, проверяющие хеш содержимого перед сохранением. Если файл успел измениться, сервер отклоняет операцию и отдаёт подсказки для смещения правок. В памяти сохраняется история до 10 шагов отмены на каждый файл.

Сборка из исходников требует Rust версии 1.95 или новее. Для повседневной работы компилятор не нужен: сервер можно запускать через `npx` с автоматической загрузкой бинарника.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add octofs -- npx -y @muvon/octofs
```

### Codex

**Командой платформы**
```bash
codex mcp add octofs -- npx -y @muvon/octofs
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "octofs": {
            "command": "npx",
            "args": [
                "-y",
                "@muvon/octofs"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "octofs": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@muvon/octofs"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add octofs npx -y @muvon/octofs
```

## Когда брать
- Искать вхождения текста в коде с показом строк контекста
- Редактировать удалённые файлы через протокол SSH
- Вносить атомарные пакетные правки в один файл
- Предотвращать перезапись кода при конфликтах хешей строк

## Примеры запросов агенту
- Найди все вызовы unwrap() в проекте и покажи контекст вокруг них
- Создай файл test.rs и добавь туда базовые модульные тесты
- Покажи структуру каталога по адресу ssh://user@server:22/var/www

## Похожие
- [termcp](https://affpapa.org/nevibecode/mcp/termcp.md) — MCP-сервер · ★ 59
- [agent-tool](https://affpapa.org/nevibecode/mcp/agent-tool.md) — MCP-сервер · ★ 24
- [sshmcp](https://affpapa.org/nevibecode/mcp/sshmcp.md) — MCP-сервер · ★ 11
- [ssh](https://affpapa.org/nevibecode/mcp/ssh.md) — MCP-сервер · ★ 81
- [system-info](https://affpapa.org/nevibecode/skills/system-info.md) — скилл · 302 установки
- [Remote Desktop Commander](https://affpapa.org/nevibecode/mcp/remote-desktop-commander.md) — MCP-сервер · ★ 194

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md