I18next Server

FreeNot checked

Enables AI assistants to manage i18next translation files, including adding keys, syncing missing translations, and analyzing coverage.

by gtrias

GitHub Embed

About

Enables AI assistants to manage i18next translation files, including adding keys, syncing missing translations, and analyzing coverage.

README

npm version License: MIT

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 statistics
health_check - Analyze translation file health and completeness
scan_code_for_missing_keys - Find missing translation keys in your code

Key Management

add_translation_key - Add new translation keys
sync_missing_keys - Sync missing keys between languages
get_missing_keys - List missing keys by language

File Operations

list_files - List all translation files
validate_files - Validate JSON syntax
export_data - Export translations to various formats

Analysis

coverage_report - Translation coverage statistics
usage_analysis - Find unused translation keys
quality_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.

🔗 Links

from github.com/gtrias/i18next-mcp-server

Install I18next Server in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install i18next-mcp-server

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add i18next-mcp-server -- npx -y i18next-mcp-server

FAQ

Is I18next Server MCP free?

Yes, I18next Server MCP is free — one-click install via Unyly at no cost.

Does I18next Server need an API key?

No, I18next Server runs without API keys or environment variables.

Is I18next Server hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install I18next Server in Claude Desktop, Claude Code or Cursor?

Open I18next Server on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Fetch

Web content fetching and conversion for efficient LLM usage.

by Community

AWS KB Retrieval

Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.

by modelcontextprotocol

Spring AI MCP Server

Provides auto-configuration for setting up an MCP server in Spring Boot applications.