Octofs — Claude Code MCP server: what it does, how to install
Gives AI coding assistants direct filesystem and remote SSH access. Enables content searching, atomic batch file editing, and command execution.
claude mcp add octofs -- npx -y @muvon/octofsWhat Octofs does
Octofs is a standalone Rust binary built on tokio and axum. It equips agents with tools to inspect directory trees while respecting .gitignore rules, locate snippets using context-aware search, and read files in chunks. It also handles remote targets directly via ssh:// URLs.
File modifications rely on composite N:hh line identifiers verified against hashes at write time. If external changes occur beforehand, the server rejects outdated edits and suggests relocation offsets. The tool handles atomic batch modifications and stores up to 10 undo steps per file in memory.
Building from source requires Rust 1.95 or later. In practice, you do not need the Rust compiler because pre-compiled binaries and an npm wrapper handle execution automatically.
What it helps with
- Search codebase text with surrounding context lines
- Modify remote files directly using
ssh://paths - Apply atomic multi-line batch edits to a single file
- Block conflicting writes via line-hash validation
Example prompts for the agent
- Find all occurrences of unwrap() in this repository and display their context
- Generate a test.rs file with basic unit tests
- Inspect the directory structure at ssh://user@server:22/var/www
How to install Octofs
Platform CLI
claude mcp add octofs -- npx -y @muvon/octofsPlatform CLI
codex mcp add octofs -- npx -y @muvon/octofsConfig file
{
"mcpServers": {
"octofs": {
"command": "npx",
"args": [
"-y",
"@muvon/octofs"
]
}
}
}Config file
{
"servers": {
"octofs": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@muvon/octofs"
]
}
}
}Platform CLI
gemini mcp add octofs npx -y @muvon/octofsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Octofs
How to install Octofs in Claude Code?
Run claude mcp add octofs -- npx -y @muvon/octofs in your terminal. The wrapper fetches the appropriate pre-compiled binary on its first run.
What does Octofs do?
It exposes filesystem tools over MCP, allowing assistants to search code, edit files atomically, handle shell tasks, and connect over SSH.
How does Octofs prevent stale writes?
Each line edit checks composite N:hh identifiers containing hash values. If the target line changed, the update fails and returns relocation hints to the model.
