I18next Mcp Server

i18next MCP Server

i18next プロジェクト向けの翻訳管理機能を提供する Model Context Protocol（MCP）サーバーです。Cursor などの AI アシスタントが翻訳ファイルを直接操作できるようにします。

🚀 クイックセットアップ

この MCP サーバーを使う最も簡単な方法は npx を使用することです。インストールは不要です。

npx i18next-mcp-server@latest --help

🔧 Cursor の設定

Cursor の MCP 設定に以下を追加してください。

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

詳しいセットアップ手順については、CURSOR_SETUP.md をご覧ください。

📁 想定されるプロジェクト構成

your-project/
├── public/locales/          # Translation files
│   ├── en/
│   │   ├── common.json
│   │   └── navigation.json
│   ├── es/
│   │   ├── common.json
│   │   └── navigation.json
│   └── ...
└── src/                     # Your source code

🛠️ 利用可能なツール

コアツール

• get_project_info - プロジェクトの設定と統計情報を取得します
• health_check - 翻訳ファイルの健全性と完全性を分析します
• scan_code_for_missing_keys - コード内の不足している翻訳キーを検索します

キー管理

• add_translation_key - 新しい翻訳キーを追加します
• sync_missing_keys - 言語間で不足しているキーを同期します
• get_missing_keys - 言語ごとに不足しているキーを一覧表示します

ファイル操作

• list_files - すべての翻訳ファイルを一覧表示します
• validate_files - JSON 構文を検証します
• export_data - 翻訳をさまざまな形式でエクスポートします

分析

• coverage_report - 翻訳のカバレッジ統計を表示します
• usage_analysis - 使用されていない翻訳キーを検索します
• quality_analysis - 翻訳の品質を分析します

🔧 環境変数

変数	説明	デフォルト
I18N_PROJECT_ROOT	プロジェクトのルートディレクトリ	現在のディレクトリ
I18N_LOCALES_PATH	翻訳ファイルへのパス	public/locales
I18N_DEFAULT_LANGUAGE	ソース言語	en
I18N_SUPPORTED_LANGUAGES	カンマ区切りの言語コード	en

🧪 開発

git clone https://github.com/gtrias/i18next-mcp-server.git
cd i18next-mcp-server
npm install
npm run build
npm test

📝 ライセンス

MIT ライセンスです。詳細については LICENSE をご覧ください。

🔗 リンク

• セットアップガイド
• コントリビューション
• 課題