Octofs

Standalone MCP filesystem tools server — view, edit, shell, workdir.

LLM Mart 8 views 189 listing impressions

Give your AI assistant filesystem superpowers

CI Coverage Rust License MCP Version

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.

Related servers

Universal MCP Server with advanced AI memory capabilities and semantic search.

30 views

MCP server for MikroTik routers: firewall, NAT, routing, DHCP, DNS, WireGuard and more via SSH.

29 views

Portable, vendor-neutral home for agent skills, MCP servers, personas, and memory.

28 views

Let Codex orchestrate external coding agents through their native harnesses.

28 views