Local MCP: File Management Tools

This is a Model Context Protocol (MCP) server written in Python using the official mcp SDK (FastMCP). It provides a suite of tools that allows LLMs to retrieve statistics about folders and directly manipulate your local file system.

Features

• get_folder_stats: Lists and counts files and subdirectories directly inside the target path (supports recursive counting).

• create_folder: Creates a new folder (and any necessary parent folders) at the specified path.

• edit_file: Creates a new file or overwrites an existing file with the provided text content.

• delete_path: Safely deletes a specific file or folder (and all its contents).

• Error handling: Returns clear JSON error messages for invalid paths or permission issues.

Related MCP server: File Operations MCP Server

Setup Instructions

1. Install dependencies: Make sure you have Python installed, then install the required mcp package:

   pip install -r requirements.txt

2. Test the server (optional): You can run the server directly to make sure it executes without errors. It will wait for MCP JSON-RPC messages via standard input/output.

   python server.py

   (Press Ctrl+C to exit)

Registering the MCP Server

To use these tools, you need to add the server to your AI editor or chat app configuration.

1. Claude Desktop

1. Open your Claude Desktop config file:

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Add the following entry. CRITICAL: You must use the absolute path to your python executable and the absolute path to server.py.

{
  "mcpServers": {
    "folder-tools": {
      "command": "C:\\Users\\YourUsername\\AppData\\Local\\Programs\\Python\\Python313\\python.exe",
      "args": [
        "D:/absolute/path/to/server.py"
      ]
    }
  }
}

(Make sure to restart Claude Desktop completely for the config to take effect!)

2. VS Code (Cline / Roo Code extensions)

Create a file at .vscode/cline_mcp_settings.json in your workspace with the same JSON configuration shown above.

3. Antigravity IDE

Register it globally by editing your ~/.gemini/config/mcp_config.json with the same JSON configuration shown above.

Example Tool Usage

Input arguments to edit_file:

{
  "path": "C:\\path\\to\\hello.txt",
  "content": "Hello World!"
}

Output returned (JSON string):

{
  "success": true,
  "message": "File edited successfully: C:\\path\\to\\hello.txt"
}