i18next-server
A comprehensive Model Context Protocol (MCP) server that provides automated translation management capabilities for Cursor and other AI assistants, enabling direct interaction with i18next translation files, health checking, missing key detection, and automated translation workflows.
Installation
npx i18next-mcp-serverAsk AI about i18next-server
Powered by Claude Β· Grounded in docs
I know everything about i18next-server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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 CURSOR_SETUP.md.
π 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 LICENSE for details.
