filesystem-edit-mcp 1.3.1

MCP server for filesystem operations with encoding support and umlaut fixing

filesystem-edit-mcp

An MCP (Model Context Protocol) server for filesystem operations with encoding support and umlaut fixing for C++ code.

Architecture

Encoding & Temp File Flow

Features

• read_text_file: Read files with configurable encoding per file extension
• edit_file: Edit files with pattern matching and automatic umlaut fixing
• Path validation: Security boundary enforcement via ALLOWED_DIRS
• Encoding support: Configure encodings per file pattern (e.g., latin-1 for .cpp)
• Umlaut fixing: Transform German umlauts in C++ string literals, comments, and character constants

Installation

Requires:

• Python ≥ 3.13
• Node.js + npx on PATH (the server spawns @modelcontextprotocol/server-filesystem as a subprocess)

Python deps (mcp, pydantic, tree-sitter, tree-sitter-cpp) are pulled in automatically by uvx:

uvx filesystem-edit-mcp /path/to/your/codebase

Configuration

Add to your MCP client config (Windsurf / Cursor / any MCP-compatible client):

{
  "mcpServers": {
    "filesystem-edit-mcp": {
      "command": "uvx",
      "args": ["filesystem-edit-mcp", "/path/to/your/codebase"]
    }
  }
}

Multiple directories:

{
  "mcpServers": {
    "filesystem-edit-mcp": {
      "command": "uvx",
      "args": ["filesystem-edit-mcp", "/path/to/dir1", "/path/to/dir2"]
    }
  }
}

Environment Variables

Variable	Description
ALLOWED_DIRS	Allowed directories (supports :, ,, ; delimiters) — CLI args take precedence
SERVER_CONFIG	Path to the server config file (default: server_config.json)

Notes:

• Windows 8.3 short paths (e.g., C:\Users\FOO~1) are automatically expanded to long form
• System temp directories (%TEMP%, %TMP%) are automatically allow-listed
• Error messages show resolved paths for easier debugging

Server Config

{
  "umlaut_config": {
    "string_mapping": { "Ä": "CAE_UMLT", "ä": "AE_UMLT" },
    "comment_mapping": { "Ä": "Ae", "ä": "ae" },
    "char_mapping": { "Ä": "CAE_UMLT_CHAR" }
  },
  "encoding_config": {
    "default": "utf-8",
    "mapping": { "*.cpp": "latin-1", "*.h": "latin-1" }
  }
}

Security

Path validation prevents access to files outside configured directories.

License

MIT