MCP File Tools — MCP-сервер для Claude Code: установка
Определяет кодировку текстовых файлов по байтам, передаёт агенту чистый UTF-8 и сохраняет правки в исходном формате. Помогает при правке старых файлов Delphi, VB6 или PHP.
Открыть на GitHubЧто делает MCP File Tools
Сервер решает проблему битого текста в файлах с кодировками CP1251 или UTF-16. Он проверяет байты содержимого. Расширения роли не играют. Модель получает текст в UTF-8, а запись идёт обратно в исходной таблице символов. Символы BOM и переносы строк CRLF сохраняются без повреждений.
Инструмент поддерживает 45 кодировок для чтения и редактирования. В составе есть detect_encoding, edit_file, grep_text_files и search_files. Команда detect_encoding отдаёт название кодировки, оценку достоверности и статус BOM. Все пути и симлинки проверяются по белому списку папок. Доступ наружу закрыт.
Для плагина Claude Code нужен Node.js 18+ в переменной PATH. Без него сервер не подключится к сессии.
Какие задачи решает
- читать файлы в кодировках CP1251, KOI8-R и UTF-16 без искажения символов
- редактировать исходники Delphi и формы VB6 с сохранением исходной таблицы символов
- искать текст через
grep_text_filesпо документам в старых кодировках - сохранять правильные окончания строк CRLF и BOM при перезаписи
Примеры запросов агенту
- Проверь кодировку файла
config.iniс помощьюdetect_encodingи выведи отчёт. - Найди строку «Ошибка соединения» через
grep_text_filesв папке с исходниками Delphi. - Открой
main.pas, замени заголовок окна на «Настройки» и сохрани файл в исходной кодировке.
Как установить MCP File Tools
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о MCP File Tools
Как установить MCP File Tools в Claude Code?
Выполните в терминале команду claude plugin marketplace add dimitar-grigorov/mcp-file-tools, а затем установите плагин через claude plugin install mcp-file-tools. Для работы потребуется Node.js 18+ в переменной PATH.
Для чего нужен MCP File Tools?
Сервер даёт возможность работать с файлами не в UTF-8, включая CP1251, KOI8 и UTF-16. Он автоматически определяет кодировку по байтам и сохраняет правки в исходном виде с нужными BOM и переносами строк.
Ограничивает ли сервер доступ к файловой системе?
Да, инструмент изолирован в песочнице. Все пути, включая символические ссылки, проверяются по списку разрешённых рабочих папок.
