gtrias/i18next-mcp-server
If you are the rightful owner of i18next-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The i18next MCP Server is a Model Context Protocol server designed to manage translations for i18next projects, facilitating direct interaction with translation files by AI assistants like Cursor.
i18next MCP Server
A Model Context Protocol (MCP) server that provides translation management capabilities for i18next projects, enabling AI assistants like Cursor to directly interact with translation files.
๐ Quick Setup
The easiest way to use this MCP server is with npx. No installation required:
npx i18next-mcp-server@latest --help
๐ง Cursor Configuration
Add this to your Cursor MCP settings:
{
"mcpServers": {
"i18next-translation": {
"command": "npx",
"args": ["-y", "i18next-mcp-server@latest"],
"env": {
"I18N_PROJECT_ROOT": "/path/to/your/project",
"I18N_LOCALES_PATH": "public/locales",
"I18N_DEFAULT_LANGUAGE": "en",
"I18N_SUPPORTED_LANGUAGES": "en,es,fr"
}
}
}
}
For detailed setup instructions, see .
๐ Expected Project Structure
your-project/
โโโ public/locales/ # Translation files
โ โโโ en/
โ โ โโโ common.json
โ โ โโโ navigation.json
โ โโโ es/
โ โ โโโ common.json
โ โ โโโ navigation.json
โ โโโ ...
โโโ src/ # Your source code
๐ ๏ธ Available Tools
Core Tools
get_project_info
- Get project configuration and statisticshealth_check
- Analyze translation file health and completenessscan_code_for_missing_keys
- Find missing translation keys in your code
Key Management
add_translation_key
- Add new translation keyssync_missing_keys
- Sync missing keys between languagesget_missing_keys
- List missing keys by language
File Operations
list_files
- List all translation filesvalidate_files
- Validate JSON syntaxexport_data
- Export translations to various formats
Analysis
coverage_report
- Translation coverage statisticsusage_analysis
- Find unused translation keysquality_analysis
- Analyze translation quality
๐ง Environment Variables
Variable | Description | Default |
---|---|---|
I18N_PROJECT_ROOT | Your project root directory | Current directory |
I18N_LOCALES_PATH | Path to translation files | public/locales |
I18N_DEFAULT_LANGUAGE | Source language | en |
I18N_SUPPORTED_LANGUAGES | Comma-separated language codes | en |
๐งช Development
git clone https://github.com/gtrias/i18next-mcp-server.git
cd i18next-mcp-server
npm install
npm run build
npm test
๐ License
MIT License - see for details.