Skip to main content

MCP server for filesystem operations with encoding support and umlaut fixing

Project description

filesystem-edit-mcp

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

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

uvx filesystem-edit-mcp

Configuration

Add to your MCP client config:

{
  "filesystem-edit-mcp": {
    "command": "uvx",
    "args": ["filesystem-edit-mcp"],
    "env": {
      "ALLOWED_DIRS": "/path/to/allowed/dir1:/path/to/dir2",
      "SERVER_CONFIG": "/path/to/server_config.json"
    }
  }
}

Environment Variables

  • ALLOWED_DIRS: Colon-separated list of directories the server can access
  • SERVER_CONFIG: Path to the server configuration file (default: server_config.json)

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" }
  }
}

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

filesystem_edit_mcp-1.1.0.tar.gz (60.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

filesystem_edit_mcp-1.1.0-py3-none-any.whl (8.1 kB view details)

Uploaded Python 3

File details

Details for the file filesystem_edit_mcp-1.1.0.tar.gz.

File metadata

  • Download URL: filesystem_edit_mcp-1.1.0.tar.gz
  • Upload date:
  • Size: 60.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for filesystem_edit_mcp-1.1.0.tar.gz
Algorithm Hash digest
SHA256 3b60634c3abe9b4af843377067a44c41c48a398dd18ae4ae94cb0fe5053a5395
MD5 864a3dd0e285d6c228df737740d6620a
BLAKE2b-256 d9afc0343c3e18de6bf8d118163864a23ffe7db95a76ebb47878e0990c3b6e5a

See more details on using hashes here.

File details

Details for the file filesystem_edit_mcp-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: filesystem_edit_mcp-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 8.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for filesystem_edit_mcp-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fa0f140011ff596f02cad8988c5ba89ac4c9419cbe4a72353ea7191d4708ad07
MD5 bb9ecb76ecfa5e2591f6bf0e25aabbd1
BLAKE2b-256 33c128c1e3acc038a1228ff71b2bc5d4ab67d4af63114c2be3ea4714fbc2d668

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page