Skip to content
MCP server

MCP File Tools

Read, edit and search non-UTF-8 files in 45 encodings without corrupting them

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
Windows, Linux, macOS
Runs
Locally
Version
4.6.2
Listing updated
today

Similar MCP servers

About MCP File Tools

MCP File Tools is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

Legacy files such as Delphi units, VB6 forms or older PHP often use CP1251, KOI8 or other code pages, and a model that reads them as UTF-8 sees garbage. This server detects each file's encoding from its bytes, hands the model clean UTF-8, and writes back in the original encoding.

Byte order marks and CRLF or LF line endings are preserved, including on UTF-16 where a naive rewrite breaks the file. Edit, grep and search tools decode the same way, and every path, symlink and junction is checked against the directories you allowed.

It ships as a Claude Code plugin (needs Node.js 18+ for the launcher), as downloadable binaries for Windows, Linux and macOS, or via go install.

Install

Run in a terminal

claude mcp add mcp-file-tools -- npx -y https://github.com/dimitar-grigorov/mcp-file-tools/releases/download/v4.6.2/mcp-file-tools_windows_amd64.exe

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-file-tools": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/dimitar-grigorov/mcp-file-tools/releases/download/v4.6.2/mcp-file-tools_windows_amd64.exe"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-file-tools": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/dimitar-grigorov/mcp-file-tools/releases/download/v4.6.2/mcp-file-tools_windows_amd64.exe"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-file-tools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/dimitar-grigorov/mcp-file-tools/releases/download/v4.6.2/mcp-file-tools_windows_amd64.exe"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-file-tools": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/dimitar-grigorov/mcp-file-tools/releases/download/v4.6.2/mcp-file-tools_windows_amd64.exe"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-file-tools": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/dimitar-grigorov/mcp-file-tools/releases/download/v4.6.2/mcp-file-tools_windows_amd64.exe"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

detect_encoding
Reports charset, confidence score and any BOM
read_text_file
Reads a file and returns UTF-8
write_file
Writes back in the original encoding
edit_file
Encoding-aware edit
grep_text_files
Encoding-aware text search
search_files
Encoding-aware file search

What it does

45 encodings
Read and write Cyrillic, Windows-125x, ISO-8859, DOS, UTF-16/32 and CJK code pages.
Detection report
Reports charset, confidence and any BOM.
Round-trip safe edits
Keeps BOM and line endings intact.
Encoding-aware search
Grep and file search decode the same way.
Directory sandbox
Paths and links must sit inside allowed folders.

Good for

  • Edit a Cyrillic Delphi project with an AI assistant
  • Diagnose why a legacy file shows question marks
  • Search a tree of mixed-encoding INI and HTML files
  • Change a UI string and save back as CP1251

Pricing

Open source

Free to download and run

MCP File Tools FAQ

How does it know the encoding?

It detects it from file bytes, not the extension, and `detect_encoding` shows confidence.

Does it need Node?

The Claude Code plugin launcher needs Node.js 18+; manual binary installs do not.

Which folders can it touch?

Only directories you pass as arguments.

Is MCP File Tools free?

Yes. MCP File Tools is open source, so you can use and self-host it for free.

How do I add MCP File Tools to Claude Code?

Run this command in your terminal: claude mcp add mcp-file-tools -- npx -y https://github.com/dimitar-grigorov/mcp-file-tools/releases/download/v4.6.2/mcp-file-tools_windows_amd64.exe

What are the best alternatives to MCP File Tools?

The closest alternatives to MCP File Tools are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers