I18next Mcp Server

Created By

gtrias9 months ago

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.

# i18next

# translations

Overview Content Tools Comments

Content

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 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

Server Config

{
  "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"
      }
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

Howtocook Mcp基于Anduin2017 / HowToCook （程序员在家做饭指南）的mcp server，帮你推荐菜谱、规划膳食，解决“今天吃什么“的世纪难题； Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"

Tavily Mcp

DeepChatYour AI Partner on Desktop

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

ChatWiseThe second fastest AI chatbot™

MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs

RedisA Model Context Protocol server that provides access to Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.

WindsurfThe new purpose-built IDE to harness magic

Serper MCP ServerA Serper MCP Server