Vulcan File Ops

Vulcan File Ops is an MCP server that provides local filesystem manipulation capabilities to desktop AI clients like Claude Desktop and Codex. It connects desktop language models to specified directories, allowing software engineers, technical writers, and researchers to read, write, edit, and organize files directly through conversational prompts. Built with Node.js and TypeScript, the server provides advanced file handling tools such as line-range reading, multi-file batch operations, pattern-based diff editing, and image vision attachment. It also supports parsing and generating office documents including PDF, DOCX, PPTX, XLSX, and ODT files. Vulcan File Ops enforces security boundaries by validating all operations against pre-configured directories specified via startup flags or registered dynamically at runtime. It includes glob and grep search capabilities, automated exclusion of bloat directories like node_modules and .git, and controlled shell execution, bringing dedicated IDE-style coding assistant capabilities into general conversational AI clients.

Category: Files, Documents & PDFs

Tags: file-management, filesystem, io, local-storage

Visit Vulcan File Ops

How to install and configure Vulcan File Ops

1. Ensure Node.js version 14 or higher is installed on your system. 2. Open your MCP client configuration file, such as claude_desktop_config.json for Claude Desktop or config.toml for Codex. 3. Add Vulcan File Ops under the client's MCP configuration settings. For JSON clients using npx: json { "mcpServers": { "vulcan-file-ops": { "command": "npx", "args": [ "-y", "@n0zer0d4y/vulcan-file-ops", "--approved-folders", "/path/to/your/allowed/directories" ] } } } 4. For Codex, add the equivalent table to C:\Users\<username>\.codex\config.toml: toml [mcp_servers.vulcan_file_ops] command = "npx" args = ["-y", "@n0zer0d4y/vulcan-file-ops"] enabled = true startup_timeout_sec = 120.0 5. Save the configuration and restart your MCP client to enable filesystem tools.

What you can do with Vulcan File Ops

• Reading and writing project files across specific lines or batches during software refactoring tasks. - Parsing and extracting text or data from PDF, DOCX, PPTX, XLSX, and ODT documents. - Searching codebases using fast glob file pattern matching and grep content filtering. - Attaching local image files directly to the model context for visual inspection and description. - Managing local folders through directory creation, moving, deleting, and runtime folder registration.

Key facts

• https://github.com/n0zer0d4y/vulcan-file-ops
• Files, Documents & PDFs
• file-management, filesystem, io, local-storage

Part of MCP Servers

How do I install Vulcan File Ops?

You can run Vulcan File Ops directly using npx without manual installation by setting the command to npx and args to -y and @n0zer0d4y/vulcan-file-ops in your client configuration. Alternatively, install it globally using npm install -g @n0zer0d4y/vulcan-file-ops or clone the repository to run the build with Node.js.

What can Vulcan File Ops do?

Vulcan File Ops provides tools for reading, writing, editing, moving, and deleting local files. It supports batch processing, pattern-based diff editing, reading specific line ranges, inspecting office documents like PDF and DOCX, searching directories via glob and grep, and executing approved shell commands within configured directory boundaries.

Which MCP clients work with Vulcan File Ops?

It works with MCP-compliant desktop clients including Claude Desktop, Cursor, and Codex. Any client implementing standard JSON or TOML MCP server configurations can connect to Vulcan File Ops over standard input and output streams.

How does Vulcan File Ops restrict folder access?

Access boundaries are established using the --approved-folders startup flag or dynamically via the register_directory tool during a conversation. Vulcan File Ops validates every requested file path against the list of approved directories before executing any read, write, or search operations.

Is Vulcan File Ops open source?

Yes, Vulcan File Ops is open source. According to its repository metadata, it is released under the MIT License and developed with TypeScript.