MCP File Tools MCP Server

MCP server for reading/writing legacy-encoded files (CP1251, Windows-1251, etc.)

Local serverstdioGo

What is the MCP File Tools MCP server?

Most developer tooling work still happens through a UI a human drives. MCP File Tools MCP server moves it into the conversation instead. MCP server for reading/writing legacy-encoded files (CP1251, Windows-1251, etc.).

The short version

MCP server for file operations on text that isn't UTF-8. It detects the encoding from the file's bytes rather than its extension, hands the model UTF-8, and writes back in the original encoding — BOM and CRLF/LF intact, still byte-compatible with whatever legacy tool owns the file.

  • read_text_file - Read files with encoding auto-detection and conversion
  • read_multiple_files - Read multiple files concurrently with encoding support
  • write_file - Write files in specific encodings
  • edit_file - Line-based edits with diff preview and whitespace-flexible matching
  • copy_file - Copy a file to a new location
  • delete_file - Delete a file

The tools it exposes

The server publishes 4 tools. What each one is for:

  • Encoding — aware across the whole tool set** — not just read and write: edit_file, grep_text_files and search_files decode the same way
  • Sandboxed — every path, including symlink and junction targets, is resolved and checked against the directories you allowed
  • Update — The server checks for updates automatically and notifies you through tool responses when a newer version is available; the notice carries the steps
  • DebuggingMCP Inspector gives a web UI for calling tools and inspecting responses (needs Node.js 18+):

What it needs from you

Configuration is passed through the environment: MCP_DEFAULT_ENCODING. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Getting it running

@modelcontextprotocol/inspector on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

How it compares

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. MCP File Tools's toolset — Encoding, Sandboxed, Update and 1 more — is a fair guide to whether it matches your workflow. It is maintained by dimitar-grigorov; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
Encodingaware across the whole tool set** — not just read and write: edit_file, grep_text_files and search_files decode the same way
Sandboxedevery path, including symlink and junction targets, is resolved and checked against the directories you allowed
UpdateThe server checks for updates automatically and notifies you through tool responses when a newer version is available; the notice carries the steps for your install. Plugin installs update through [Updating the plugin](#
Debugging[MCP Inspector](https://github.com/modelcontextprotocol/inspector) gives a web UI for calling tools and inspecting responses (needs Node.js 18+):

How to install the MCP File Tools MCP server

macOS / Linux:
```json
{
  "mcpServers": {
    "file-tools": {
      "command": "/Users/YOUR_NAME/.local/bin/mcp-file-tools",
      "args": ["/Users/YOUR_NAME/Projects", "/Users/YOUR_NAME/Documents"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
MCP_DEFAULT_ENCODINGConfiguration value read at startup.Optional

Example prompts to try

  • Use MCP File Tools to Encoding.
  • Use MCP File Tools to Sandboxed.
  • Use MCP File Tools to Update.

Frequently asked questions

It connects MCP File Tools to MCP-compatible AI assistants such as Claude and Cursor, exposing 4 tools (Encoding, Sandboxed, Update, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with MCP File Tools directly.