i18n-mcp
MCP server for Rails YAML and JSON locale files: read, search, write and audit translations
- 0 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Runs a local process from npm
- Modifies and deletes keys in the project's locale files
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/i18n-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs a local process from npm
- Modifies and deletes keys in the project's locale files
This is third-party code. Review the repository files before installing.
What it does
Gives an agent tools for a Rails app's config/locales directory. It can list locales and keys, search keys and values, create, update and delete keys, and find missing translations and placeholder mismatches. Writes go through the YAML AST, so comments and key order are preserved.
Who it is for. Developers of multilingual Rails applications.
Good fit when
- Add new UI strings to all locales at once
- Find missing translations and empty values before a release
- Check that %{...} placeholders match the base locale
Not a fit when
- The project is not Rails and uses another format such as gettext or i18next
- You need machine translation: the server only manages files
Example request
Find keys under dashboards that have no Russian translation and add themMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
I18N_LOCALES_DIR- Locales directory when --locales-dir is not passed
Limitations
Supports Rails-style locale layouts in .yml, .yaml and .json files. Duplicate keys use last-wins semantics like Rails. Files that fail to parse are reported under problems but not edited. The default base locale for audits is en.
How to disable. Remove the i18n block from mcpServers in the client config.
FAQ
Are YAML comments preserved?
Yes, writes go through the YAML AST, so comments and key order survive.
Where do new keys go?
Into the key's current file, the nearest prefix's file, or the default common.yml, which --default-file changes.
Discussion
No questions or reviews yet.
Related
MCP serversA bridge from an LSP language server to the agent: definitions, references, diagnostics, hover and symbol rename
An MCP server that lets an agent read files, search code and run commands in a workspace
Docs MCP Server
Grounded Docs MCP Server
A local MCP server that indexes docs from websites, GitHub, npm, PyPI and files and gives the agent version-aware search
A plugin with skills for building TypeScript MCP servers and MCP apps: the agent scaffolds, edits, debugs and verifies them
mcpdoc
MCP LLMS-TXT Documentation Server
An MCP server from LangChain that serves docs from the llms.txt files you choose, with auditable tool calls
A remote MCP server that gives the agent docs and code of any public GitHub repository with nothing to install
README in short
i18n-mcp works with a Rails locales directory and detects both per-locale folder and flat file layouts. It runs via npx without install or builds from source. Seven tools cover listing locales and keys, getting, searching, setting, deleting and auditing translations. The project has tests with enforced coverage thresholds and a stdio smoke test.