Octofs

Name: Octofs
Author: LLM Mart

No install snippet on purpose. A working MCP config is a command, its arguments and an environment block — the last two are where API keys live, so this catalogue never stores them and cannot publish them. Follow the link above for the authors' own instructions.

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: