Octofs
File Operations • AST Search • Batch Editing • Shell
The fastest filesystem MCP server for AI coding assistants. Native Rust performance, built-in AST intelligence via ast-grep, atomic batch edits, and safety-first design. Give Cursor, Claude, and Windsurf intelligent filesystem access.
brew install muvon/tap/octofsKey Features
Smart File Operations
Intelligent file reading with automatic truncation for large files — no more blowing context windows on a 10K-line file. Glob patterns, gitignore-aware traversal, and hidden file handling. Context-aware session isolation keeps AI tools focused.
Atomic Batch Editing & AST Search
Multi-file operations are all-or-nothing — no half-applied refactors. Structural code search via ast-grep finds patterns by syntax, not text. Extract function signatures without reading full implementations. Diff previews before applying changes.
Native Performance & Shell Integration
Rust-native speed means sub-millisecond responses vs. Python/Node.js alternatives. Run shell commands with background process support. Working directory management with session isolation. MCP tool descriptions are lean — no wasting 40-50% of context windows.
Why Octofs?
MCP tool descriptions consume 40-50% of context windows
Lean, efficient tool definitions that maximize available context for actual work. Rust binary with minimal overhead — not bloated Python/Node.js servers.
Text-based search misses structural code patterns
Built-in ast-grep searches by syntax tree, not text. Find "fn $NAME($$$ARGS) -> Result" regardless of formatting, comments, or naming conventions.
Multi-file edits can leave code in broken states
Atomic batch operations are all-or-nothing. Either every file is updated correctly, or nothing changes. Diff previews let AI verify before applying.
MCP Tools
Available via Model Context Protocol for AI assistants
view Read files, list directories, search content with glob patternstext_editor Create, edit, and replace text with precisionbatch_edit Atomic multi-file operations with diff previewsast_grep Structural code search — find patterns by syntax, not textview_signatures Extract function/type signatures without implementationshell Execute commands with background process supportworkdir Manage working directory for context-aware operationsWhen to Use Octofs
AI-Powered Refactoring
Find all uses of a deprecated API with ast-grep, generate batch edits across 8+ files, apply them atomically. No half-applied changes, no missed call sites.
Codebase Exploration
List directory trees, extract signatures, search patterns — give AI assistants a complete understanding of your project structure without reading every file.
Safe AI Editing
Gitignore-aware means AI tools never read or expose .env files, credentials, or build artifacts. Path validation prevents unauthorized filesystem access.
Development Automation
Run test suites, build commands, and scripts directly through MCP. Background process support means long-running commands don't block the AI workflow.
Works With
Install
Homebrew
brew install muvon/tap/octofs One command. Auto-updates. No build step.
Build from Source
git clone https://github.com/muvon/octofs && cd octofs && cargo build --releaseTech Stack
Built in the Open
Octofs is open source under the Apache 2.0 license. Contributions, issues, and stars are welcome.