# Octofs

> Octofs is an open-source MCP server for developer tools. Rust filesystem server for AI assistants: view, edit, search, run shell commands. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, self-hosted
- **Repository:** https://github.com/muvon/octofs
- **MCP Registry name:** io.github.Muvon/octofs
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add octofs -- npx -y @muvon/octofs
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "octofs": {
      "command": "npx",
      "args": [
        "-y",
        "@muvon/octofs"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "octofs": {
      "command": "npx",
      "args": [
        "-y",
        "@muvon/octofs"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "octofs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@muvon/octofs"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "octofs": {
      "command": "npx",
      "args": [
        "-y",
        "@muvon/octofs"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "octofs": {
      "command": "npx",
      "args": [
        "-y",
        "@muvon/octofs"
      ]
    }
  }
}
```

## Tools

- `view`: Read files, list directories with glob patterns and search content.
- `batch_edit`: Apply multiple insert and replace operations atomically to a single file.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/octofs
