I18n MCP Server

🚀 🌐 i18n MCP サーバー

i18n MCP サーバーは、プロジェクトの国際化（i18n）管理に役立つ強力なツールです。強力な言語モデルを便利なサーバーインターフェースに統合することで、単一の基本言語ファイルから JSON ベースの言語ファイルを生成する翻訳プロセスを簡素化します。

この MCP サーバーは、Cursor IDE で stdio 転送を使用するために設計されています。他の stdio 転送をサポートするクライアントでも正常に動作するはずです。

💡 なぜ i18n MCP サーバーを選ぶのか？

• 数時間の手動翻訳作業を節約します。
• i18n ファイルを一貫性があり最新の状態に保ちます。
• アプリケーションをグローバルに拡張する際の繰り返しのコピー/ペースト作業を排除します。

✨ 主な機能

🌍 多言語対応

単一の基本言語ファイルから複数の言語の翻訳を自動生成します。

🤖 Cursor 内の言語モデルを使用した翻訳

追加の翻訳サービス料金を支払う必要はありません。使用する翻訳モデルを選択し、必要に応じて翻訳を生成します。

⚡ スムーズなワークフロー

JSON ファイルを手動でコピーまたは編集する必要はありません。リクエストを送信するだけで、すぐに使用可能な翻訳ファイルが得られます。

🛠️ 開発者にやさしい

シンプルかつ迅速に構築され、開発パイプラインにシームレスに統合されます。

🚀 クイックスタート

この MCP サーバーは、JSON ファイルの翻訳を段階的に管理するのに役立ちます。以下のような簡単なツールを提供します。

1. すべてのテキストを 1 つの言語で含み、サポートされる言語のセットを持つ基本言語ファイルを取得します。
2. 翻訳するテキストブロックを取得します。各ブロックは、改行で区切られたテキストのリストになります。
3. 生成された翻訳をメモリキャッシュに更新します。
4. 翻訳を特定の言語の JSON ファイルに保存します。

📦 インストール

1. リポジトリをクローンします。

git clone

2. 依存関係をインストールします。

pnpm install # または npm/yarn

3. サーバーをビルドします。

pnpm run build

4. Cursor で MCP サーバーを設定します。

Cursor Settings / MCP に移動し、新しい MCP サーバーを追加するためにクリックします。開いた JSON ファイルに、サーバーの定義を含めます。

{
  "mcpServers": {
    ...
    "i18n-translation-server": {
      "command": "node",
      "args": ["<base-path>/i18n-mcp/dist/mcp_server.js"]
    },
    ...
  }
}

<base-path> を、正しくコンパイルされたサーバーの絶対パスに置き換える必要があります。

💻 使用例

基本的な使用法

MCP サーバーが起動したら、Cursor Agent を使用してサーバーツールとやり取りできます。例えば：

プロジェクトの i18n ファイルを準備しており、基本言語ファイルがあります。以下のデータを使用して、必要な他の言語を準備するために提案されたタスクを実行します。

基本 JSON 言語ファイル：[絶対パス] 基本言語ファイルへ
基本言語：[基本言語]
サポートされる言語：[カンマ区切りのサポート言語リスト]

以下のタスクを実行する必要があります。

1. 以前のデータをクリアします。
2. 基本言語ファイルを読み取ります。
3. すべての翻訳が必要な文字列を取得します。
4. 各文字列を翻訳 API に送信して翻訳します。
5. 翻訳結果を対応する目標言語ファイルに保存します。

すべての文字列が翻訳されるまで、手順 3 - 5 を繰り返します。

注意事項

⚠️ 重要提示

1. システムに Node.js と PNPM がインストールされていることを確認してください。
2. サーバーを実行する前に、すべての依存関係が正しくインストールされていることを確認してください。
3. 何らかの問題が発生した場合は、ネットワーク接続を確認してください。一部の API 呼び出しにはインターネットアクセスが必要な場合があります。

ご不明な点があれば、いつでもお問い合わせください。