Octofs
Expose filesystem view, edit, shell, ast-grep, and workdir tools to your agent as a standalone MCP server.
Overview
io.github.Muvon/octofs is an MCP server for the Build phase that provides standalone filesystem tools including view, edit, shell, ast-grep, and workdir control.
What is this MCP server?
- View and edit files through MCP tools
- Shell execution with configurable workdir context
- ast-grep structural search for code patterns
- Workdir-scoped operations for multi-repo setups
- Standalone server version 0.1.0 — view, edit, shell, ast-grep, workdir
- Server version 0.1.0 per publisher server.json
- Five advertised capability areas: view, edit, shell, ast-grep, workdir
What problem does it solve?
Your agent needs reliable, scoped file and shell operations, but bundled tool servers are heavy or missing structural search.
Who is it for?
Indie devs who want a minimal filesystem-plus-shell MCP with ast-grep for agent-driven refactors on local repos.
Skip if: Cloud-only workflows that forbid local shell execution or teams requiring enterprise sandboxing out of the box.
What do I get? / Deliverables
After registration, the agent can read, edit, run commands, and ast-grep the repo within declared workdirs from one MCP endpoint.
- Agent-accessible file view and edit operations
- Shell commands run inside declared workdirs
- ast-grep pattern searches over project source
Recommended MCP Servers
Journey fit
Filesystem MCP is foundational Build agent-tooling, yet you reuse it across Ship review and Operate hotfixes on the same machine. Agent-tooling is the right shelf for low-level repo manipulation servers that agents invoke hundreds of times per session.
How it compares
Filesystem and shell MCP, not semantic memory or codebase graph indexing.
Common Questions / FAQ
Who is io.github.Muvon/octofs for?
Builders using MCP agents who need direct repo file, shell, and ast-grep tools in one lightweight server.
When should I use io.github.Muvon/octofs?
Use it when your agent’s default file tools are insufficient and you want structural search plus explicit workdir-scoped commands.
How do I add io.github.Muvon/octofs to my agent?
Add the octofs MCP server to your client config, set allowed workdirs to your project roots, and restrict shell tools if your environment contains secrets.