Octofs
Rust filesystem server for AI assistants: view, edit, search, run shell commands
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.25.2
- Listing updated
- today
Similar MCP servers
About Octofs
Octofs is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Octofs is a single compiled Rust binary rather than a Python or Node script, installable with cargo, Homebrew, npx or a prebuilt release for Linux, macOS and Windows on x64 and ARM64. Release bundles in .mcpb format give one-click install in clients like Claude Desktop.
Its edit model is the distinctive part. Lines are addressed by composite ids such as N:hh that are hash-verified when an edit is applied, so a stale edit fails with a hint about where the text moved instead of writing to the wrong place. Batch edits apply several inserts and replaces atomically to one file, with undo of up to 10 levels per file. Re-viewing a file can return only the hunks changed since, for clients that report a context epoch.
It also searches content with context lines, respects .gitignore, truncates large files sensibly, runs shell commands with automatic hand-off to the background, and manages working directories. Every file tool accepts ssh:// URLs for transparent SSH and SFTP. It speaks stdio and Streamable HTTP, and pairs with the same author's Octocode, which emits the same line ids.
Install
Run in a terminal
claude mcp add octofs -- npx -y @muvon/octofsAdd to claude_desktop_config.json
{
"mcpServers": {
"octofs": {
"command": "npx",
"args": [
"-y",
"@muvon/octofs"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"octofs": {
"command": "npx",
"args": [
"-y",
"@muvon/octofs"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"octofs": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@muvon/octofs"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"octofs": {
"command": "npx",
"args": [
"-y",
"@muvon/octofs"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"octofs": {
"command": "npx",
"args": [
"-y",
"@muvon/octofs"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- view
- Read files, list directories with glob patterns and search content.
- batch_edit
- Apply multiple insert and replace operations atomically to a single file.
What it does
- Hash-verified line ids
- Edits carry N:hh ids that are checked at apply time, so stale edits fail with relocation hints.
- Atomic batch edits
- Several inserts and replaces on one file apply together, with up to 10 undo levels.
- Remote files over SSH
- Every file tool accepts ssh:// URLs for SSH and SFTP access.
- Shell and workdir
- Runs commands with automatic foreground-to-background handoff and manages working directories.
- Delta views
- Re-viewing a file returns only changed hunks for clients that report a context epoch.
- Gitignore-aware search
- Searches content with context lines while respecting .gitignore.
Good for
- Let a coding assistant refactor error handling across a repo
- Edit files on a remote server without leaving the assistant
- Apply several changes to one file in a single safe step
- Pair with a code-structure search tool to find then edit definitions
Pricing
Open source
Free and open source
Octofs FAQ
What does it run on?
Prebuilt binaries cover Linux, Windows and macOS on x86_64 and ARM64, or build from source with Rust 1.95 or newer.
How are bad edits prevented?
Edit targets carry hash-verified line ids and stale writes are detected, with an error showing current context.
Which transports does it support?
stdio and Streamable HTTP.
Can it work on remote machines?
Yes, every file tool accepts ssh:// URLs.
Is Octofs free?
Yes. Octofs is open source, so you can use and self-host it for free.
How do I add Octofs to Claude Code?
Run this command in your terminal: claude mcp add octofs -- npx -y @muvon/octofs
What are the best alternatives to Octofs?
The closest alternatives to Octofs are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


