MCP File Tools
Read, edit and search non-UTF-8 files in 45 encodings without corrupting them
- 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.exeAdd 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"
]
}
}
}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"
]
}
}
}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.


