dimitar-grigorov avatar

MCP File Tools

dimitar-grigorov/mcp-file-tools

Solves the legacy encoding problem that breaks most AI file operations. Exposes 21 tools including read_text_file, write_file, edit_file, and grep_text_files, all with automatic detection and conversion across 22 encodings: Windows-125x, ISO-8859, KOI8-R, CP866, and UTF variants with BOM handling. Built in Go, runs as a stdio transport with directory-based access control. You'll want this when working with Delphi projects, old VB6 codebases, or any PHP/HTML sites that predate UTF-8. Instead of seeing corrupted Cyrillic or Western European characters, Claude reads the actual text. Also includes tree views, regex search, line ending conversion, and encoding detection with confidence scores.

GitHub stars
30
tools
20
transport
STDIO
last updated
Oct 31, 2026

Tools

20 tools

Public tool metadata for what this MCP can expose to an agent.

read_text_fileRead files with encoding auto-detection and conversion

Read files with encoding auto-detection and conversion

No parameter schema in public metadata yet.

read_multiple_filesRead multiple files concurrently with encoding support

Read multiple files concurrently with encoding support

No parameter schema in public metadata yet.

write_fileWrite files in specific encodings

Write files in specific encodings

No parameter schema in public metadata yet.

edit_fileLine-based edits with diff preview and whitespace-flexible matching

Line-based edits with diff preview and whitespace-flexible matching

No parameter schema in public metadata yet.

copy_fileCopy a file to a new location

Copy a file to a new location

No parameter schema in public metadata yet.

delete_fileDelete a file

Delete a file

No parameter schema in public metadata yet.

list_directoryBrowse directories with pattern filtering

Browse directories with pattern filtering

No parameter schema in public metadata yet.

treeCompact indented tree view, optionally annotated with each file's encoding

Compact indented tree view, optionally annotated with each file's encoding

No parameter schema in public metadata yet.

search_filesRecursively search for files matching glob patterns

Recursively search for files matching glob patterns

No parameter schema in public metadata yet.

grep_text_filesRegex search in file contents with encoding support

Regex search in file contents with encoding support

No parameter schema in public metadata yet.

detect_encodingAuto-detect file encoding with confidence score

Auto-detect file encoding with confidence score

No parameter schema in public metadata yet.

convert_encodingConvert file between encodings

Convert file between encodings

No parameter schema in public metadata yet.

manage_line_endingsDetect or convert line endings (CRLF/LF/mixed)

Detect or convert line endings (CRLF/LF/mixed)

No parameter schema in public metadata yet.

manage_bomDetect, strip, or add Unicode BOM

Detect, strip, or add Unicode BOM

No parameter schema in public metadata yet.

list_encodingsShow all supported encodings

Show all supported encodings

No parameter schema in public metadata yet.

get_file_infoGet file/directory metadata

Get file/directory metadata

No parameter schema in public metadata yet.

create_directoryCreate directories recursively (mkdir -p)

Create directories recursively (mkdir -p)

No parameter schema in public metadata yet.

move_fileMove or rename files and directories

Move or rename files and directories

No parameter schema in public metadata yet.

list_allowed_directoriesShow accessible directories

Show accessible directories

No parameter schema in public metadata yet.

check_for_updatesCheck whether a newer release is available

Check whether a newer release is available

No parameter schema in public metadata yet.

Sponsors

Readme

MCP File Tools

Release Downloads Test OpenSSF Scorecard License: GPL-3.0 MCP Registry Glama score

Claude sees Настройки — not ???? or Íàñòðîéêè.


View the full README on GitHub

Details

Repository
github.com/dimitar-grigorov/mcp-file-tools
Package
https://github.com/dimitar-grigorov/mcp-file-tools/releases/download/v4.6.2/mcp-file-tools_windows_amd64.exe
Transport
STDIO
Registry
MCP registry, active