FS

This MCP server provides a comprehensive File System integration for Claude, enabling directory management, file operations, and Office document creation/editing through a suite of tools. Available capabilities include listing directory contents, creating and deleting directories, reading and editing files (with support for line-specific reads and targeted modifications), copying and moving files, and retrieving metadata about files and directories. It also includes an advanced directory-tree view for visualization and multiple utilities for handling Excel workbooks (creating and reading spreadsheets) and other Office-related tasks. To maximize usefulness, enable the permissions manager to selectively grant read or read-write access to specific paths, ensuring Claude can perform only the operations you authorize. When prompting Claude, explicitly indicate that you want to use the file system MCP tools to ensure the model uses these capabilities in its responses.

Prerequisites:

• Node.js v16 or newer installed on your system
• npm (bundled with Node.js) available in your PATH

Installation steps:

1. Clone the repository git clone https://github.com/chayan-1906/FS-MCP.git cd FS-MCP

2. Install dependencies npm install

3. Build and run the MCP server

   • Development mode (hot-reload/build tooling): npm run dev
   • Full build and packaging workflow (optional): npm run build npm run bundle npm run package

4. Start the server (if not using dev/scripted run): Ensure the server is accessible at http://localhost:20252 and the permissions manager is available there.

5. Verify the server is running Open http://localhost:20252 in your browser to confirm the permissions manager is functional.

Tips and notes:

• The server exposes a permissions manager at http://localhost:20252 for granting read or read-write access to specific paths. Use this to constrain Claude's file system operations.
• The toolset includes high-level filesystem operations (list/create/delete/move), file-level actions (read, create, modify, copy, delete), and metadata queries. It also supports directory-tree visualization and Office document operations like creating Excel sheets.
• Since the server runs locally, ensure port 20252 is open and not blocked by a firewall. If you run multiple instances, use different ports or stop previous instances before starting a new one.
• The “No File Picker” limitation means paths must be entered manually in the permissions UI. Double-check paths to avoid permission errors.
• If you rename or move the executable or binary, you may need to restart the MCP service to re-establish connections.