BACH FileCommander

What BACH FileCommander MCP server does

BACH FileCommander MCP server gives an MCP-compatible assistant access to local files, directories, searches, and operating-system processes. Its file tools cover common operations such as reading content, creating or appending to files, line-based edits, unique-string replacement, directory listing, metadata inspection, copying, moving, and deletion.

Deletion can be permanent through the file and directory delete tools, or recoverable through the safe-delete operation, which moves items to the platform's Recycle Bin or Trash.

The server also exposes process and session controls. An agent can run a blocking shell command, launch a background process, inspect running processes, terminate a process, or create an interactive Python, Node.js, or shell session and exchange input and output with it.

How it works

BACH FileCommander MCP server uses standard MCP over stdio. Tool names use the fc_ prefix, which separates its operations from tools supplied by other servers. The server runs locally and acts on paths and processes available to its host environment.

Search is available in several forms. Filename search accepts wildcard patterns and can run synchronously. Content search works against an explicitly ordered list of files and supports literal or regular-expression matching, case options, context, global matching, and per-file limits. For longer-running searches, an agent can start a background job, retrieve paginated results, list jobs, stop a job, or clear completed search state.

File previews provide MIME type and size before bounded inline content is requested. Multiple-file reads support up to 20 files in one call. Interactive sessions provide separate operations for starting a session, reading output, sending input, and listing active sessions.

Setup and configuration

Install and run the package as a Node.js MCP server using the project’s standard stdio configuration. Node.js 20 or newer is required according to the repository metadata.

Configure the MCP client to launch the server through stdio, then grant access only in environments where local file and process operations are appropriate. The README identifies Claude Code, Codex, Gemini, and Cursor among its example agent clients.

Tools and capabilities

The documented tool surface includes:

• Read, preview, batch-read, write, append, edit, and string-replace files.
• List, create, copy, move, inspect, and delete files or directories.
• Send deleted items to the Recycle Bin or Trash with safe delete.
• Search filenames synchronously or run content and background searches with result management.
• Execute shell commands, start background processes, list processes, and terminate processes.
• Start interactive sessions and exchange input and output with them.
• Open an existing local path with the operating system’s default application.

Limitations and notes

Operations affect the local host, so path access, process permissions, command availability, and operating-system behavior can limit results. Shell execution and process termination should be treated as privileged actions within the user’s environment. Permanent deletion is distinct from safe deletion and may not be recoverable. Content search is bounded to the explicit file list rather than performing unrestricted recursive content scanning.