Octofs
Standalone MCP filesystem tools server — view, edit, shell, workdir.
Give your AI assistant filesystem superpowers
Standalone Rust binary that exposes filesystem tools over the Model Context Protocol. Built on rmcp 3.x, tokio, and axum.
Installation · Quick Start · Features · Tools Reference · Architecture · Changelog
MCP Registry: io.github.Muvon/octofs
Why Octofs?
Your AI coding assistant (Cursor, Claude, Windsurf, etc.) is smart — but it's blind to your filesystem. Octofs bridges that gap, giving your AI:
- Eyes — Read files, search content, explore directories
- Hands — Create, edit, batch-modify files atomically
- Context — Execute commands, manage working directories
- Reach — Transparent SSH/SFTP: every file tool accepts
ssh://URLs
┌─────────────────────────────────────────────────────────────┐
│ You: "Refactor all error handling to use anyhow::Context" │
├─────────────────────────────────────────────────────────────┤
│ AI without Octofs: │
│ • "I can't see your project structure" │
│ • "Please paste the relevant files" │
│ • *Wastes 10 minutes on back-and-forth* │
├─────────────────────────────────────────────────────────────┤
│ AI with Octofs: │
│ • Reads your codebase directly │
│ • Finds all error handling patterns │
│ • Suggests atomic batch edits │
│ • Applies changes with your approval │
└─────────────────────────────────────────────────────────────┘
What Makes It Different
| Feature | Octofs | Typical Alternatives |
|---|---|---|
| Implementation | Compiled Rust binary, no runtime | Python/Node script |
| Content Search | Built-in search with context lines | String matching only |
| Batch Operations | Atomic multi-edit on single file | One-at-a-time |
| Line Addressing | Composite N:hh ids — hash-verified at apply time; stale edits fail with relocation hints |
Number-only |
| Transport | STDIO + Streamable HTTP | STDIO only |
| Shell Integration | Automatic foreground-to-background handoff | Limited or none |
| Remote Files | Transparent SSH/SFTP on every file tool | None |
| Re-reads | Delta views — re-viewing a file returns only the hunks changed since | Full file every time |
| Safety | Gitignore-aware, stale-write detection, path validation | Full filesystem access |
Installation
Cargo (crates.io)
cargo install octofs
Homebrew
brew install muvon/tap/octofs
npm (no Rust toolchain needed)
npx -y @muvon/octofs --version
The wrapper downloads the matching pre-built binary on first run. MCP config:
{
"mcpServers": {
"octofs": {
"command": "npx",
"args": ["-y", "@muvon/octofs", "mcp"]
}
}
}
Pre-built Binaries
Download from GitHub Releases for your platform:
From the project's README.