i18n-mcp
MCP-сервер для файлов локализации Rails в YAML и JSON: чтение, поиск, запись и аудит переводов
Установка
{
"mcpServers": {
"i18n": {
"command": "npx",
"args": [
"-y", "mcp-i18n",
"--locales-dir", "/path/to/rails-app/config/locales"
]
}
}
}Подходит для Claude Desktop, Kimi Code и других MCP-клиентов.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Дает агенту инструменты для работы с каталогом config/locales приложения Rails. Агент может перечислять локали и ключи, искать по ключам и значениям, создавать, обновлять и удалять ключи и находить недостающие переводы и расхождения плейсхолдеров. Запись идет через YAML AST, поэтому комментарии и порядок ключей сохраняются.
Для кого. Разработчикам Rails-приложений с несколькими языками интерфейса.
Подходит, если
- Добавить новые строки интерфейса сразу во все локали
- Найти недостающие переводы и пустые значения перед релизом
- Проверить совпадение плейсхолдеров %{...} с базовой локалью
Не подходит, если
- Проект не на Rails и использует другой формат локализации, например gettext или i18next
- Нужен машинный перевод: сервер только управляет файлами
Пример запроса к агенту
Найди ключи в разделе dashboards, у которых нет перевода на русский, и добавь ихОграничения
Поддерживает раскладки локалей в стиле Rails в файлах .yml, .yaml и .json. Дублирующиеся ключи обрабатываются по правилу последнего значения, как в Rails. Файлы, которые не удалось разобрать, попадают в раздел problems, но не редактируются. Базовая локаль для аудита по умолчанию en.
Как отключить. Удалите блок i18n из mcpServers в конфиге клиента.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| I18N_LOCALES_DIR | Каталог локалей, если не передан --locales-dir |
Проверка безопасности
- Запускает локальный процесс из npm
- Изменяет и удаляет ключи в файлах локализации проекта
Коротко о README
i18n-mcp работает с каталогом локалей Rails и автоматически распознает раскладку по папкам локалей и плоские файлы. Можно запускать через npx без установки или собрать из исходников. Семь инструментов покрывают список локалей и ключей, получение, поиск, запись, удаление и аудит переводов. Проект покрыт тестами с порогами покрытия и smoke-тестом по stdio.
Частые вопросы
Сохранятся ли комментарии в YAML?
Да, запись идет через YAML AST, комментарии и порядок ключей сохраняются.
Куда попадают новые ключи?
В текущий файл ключа, файл ближайшего префикса или файл по умолчанию common.yml, который меняется опцией --default-file.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything
Актуальная документация и примеры кода нужной версии библиотеки прямо в контексте агента, через MCP или CLI со скиллом