i18n-agent

🌍 i18n-agent MCP クライアント

Model Context Protocol（MCP）を使用する Claude、Cursor、VS Code、Antigravity、その他の AI IDE 向けのプロフェッショナルな翻訳サービスクライアントです。

✨ 機能

• 🎯 スマート翻訳：文化的な適応を取り入れた、コンテキストを考慮した翻訳
• 📁 ファイル翻訳：JSON、YAML、CSV、XML、Markdown などに対応
• ⚡ 大容量ファイル対応：50KB を超えるファイルを進捗状況を追跡しながら非同期処理
• 🔄 タイムアウトの改善：大容量ファイルの翻訳向けにタイムアウトを延長（5～10 分）
• 📊 進捗状況の追跡：ジョブのステータスと完了状況をリアルタイムで監視
• 💰 クレジットの追跡：クレジット残高と推定語数をリアルタイムで確認
• 🌐 48 言語：地域別のバリエーションを含む幅広い言語に対応
• 🔧 簡単セットアップ：主要な AI IDE にワンコマンドでインストール

🚀 クイックインストール

npx @i18n-agent/mcp-client install

インストーラーが利用可能な AI IDE をすべて検出し、自動的に設定します。

Claude Code マーケットプレイスからのインストール

Claude Code ユーザーは、マーケットプレイスから直接インストールできます。

ステップ 1：API キーを取得する

• app.i18nagent.ai にアクセスします
• サインアップするか、ログインします
• API キーをコピーします（「i18n_」で始まります）

ステップ 2：環境変数を設定する

echo 'export I18N_AGENT_API_KEY=your-api-key-here' >> ~/.zshrc
source ~/.zshrc

your-api-key-here を実際の API キーに置き換えます。

ステップ 3：マーケットプレイスからインストールする

/plugin marketplace add i18n-agent/mcp-client
/plugin install i18n-agent@i18n-agent

ステップ 4：Claude Code を再起動する

これで完了です。プラグインは環境変数から API キーを自動的に使用します。

🔑 API キーの設定

1. app.i18nagent.ai から API キーを取得します

2. 環境変数を設定します：

   export I18N_AGENT_API_KEY=your-api-key-here
   

3. 設定を永続化します（~/.bashrc または ~/.zshrc に追加します）：

   echo 'export I18N_AGENT_API_KEY=your-api-key-here' >> ~/.zshrc
   

4. AI IDE を再起動して新しい設定を読み込みます

🎮 使用例

テキストの翻訳

Translate "Hello, how are you?" to Spanish for a casual audience

ファイルの翻訳

Translate this JSON file to French, preserving the structure

クレジットの確認

Check my translation credits

対応言語

List supported languages with quality ratings

コンテンツ分析

Analyze "Hello world! This is a test." for translation to Spanish

🛠 対応 AI IDE

IDE	ステータス	macOS	Windows	Linux
Claude Desktop	✅ 自動設定	~/Library/Application Support/Claude/	%APPDATA%\Claude\	~/.config/Claude/
Claude Code CLI	✅ 自動設定	~/.claude.json	~/.claude.json	~/.claude.json
Cursor	✅ 自動設定	~/.cursor/mcp_settings.json	~/.cursor/mcp_settings.json	~/.cursor/mcp_settings.json
VS Code	✅ 自動設定	~/.vscode/mcp_settings.json	~/.vscode/mcp_settings.json	~/.vscode/mcp_settings.json
Codex (OpenAI)	✅ 自動設定	~/.codex/mcp_settings.json	~/.codex/mcp_settings.json	~/.codex/mcp_settings.json
Antigravity (Google)	✅ 自動設定	~/.gemini/antigravity/mcp_config.json	%USERPROFILE%\.gemini\antigravity\mcp_config.json	~/.config/antigravity/mcp_config.json

**注：**インストーラーはプラットフォームを自動的に検出し、適切な設定パスを使用します。

🌐 対応言語（48 言語）

• bg: ブルガリア語
• ca: カタルーニャ語
• cs: チェコ語
• da: デンマーク語
• de: ドイツ語
• el: ギリシャ語
• en: 英語
• en-AU: 英語（オーストラリア）
• en-CA: 英語（カナダ）
• en-GB: 英語（英国）
• en-US: 英語（米国）
• es: スペイン語
• es-MX: スペイン語（メキシコ）
• et: エストニア語
• fi: フィンランド語
• fr: フランス語
• fr-CA: フランス語（カナダ）
• hi: ヒンディー語
• hr: クロアチア語
• hu: ハンガリー語
• id: インドネシア語
• is: アイスランド語
• it: イタリア語
• ja: 日本語
• ko: 韓国語
• lt: リトアニア語
• lv: ラトビア語
• ms: マレー語
• nl: オランダ語
• no: ノルウェー語
• pl: ポーランド語
• pt: ポルトガル語
• pt-BR: ポルトガル語（ブラジル）
• ro: ルーマニア語
• ru: ロシア語
• sk: スロバキア語
• sl: スロベニア語
• sr: セルビア語
• sv: スウェーデン語
• th: タイ語
• tl: フィリピン語
• tr: トルコ語
• uk: ウクライナ語
• vi: ベトナム語
• zh-Hans: 中国語（簡体字）
• zh-Hant-HK: 中国語（繁体字、香港）
• zh-Hant-TW: 中国語（繁体字、台湾）

📁 対応ファイル形式

形式	拡張子	特徴
JSON	.json	構造やネストされたオブジェクトを保持します
YAML	.yaml, .yml	書式やコメントを維持します
CSV	.csv	引用符付きフィールドやカンマを処理します
XML/HTML	.xml, .html	テキストコンテンツを抽出します
Markdown	.md	書式を保持し、コードをスキップします
Properties	.properties	Java のプロパティのキーと値のペア
プレーンテキスト	.txt	直接翻訳します
PDF	.pdf	テキストを抽出して翻訳します
Word	.docx, .doc	ドキュメントを翻訳します
Gettext	.po, .pot, .mo	ローカライズ用ファイル形式

🔧 手動セットアップ

自動インストールに失敗した場合は、IDE を手動で設定できます。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "i18n-agent": {
      "command": "node",
      "args": ["/path/to/i18n-agent.js"],
      "env": {
        "MCP_SERVER_URL": "https://mcp.i18nagent.ai",
        "I18N_AGENT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor / VS Code

.cursor/mcp_settings.json または .vscode/mcp_settings.json を作成します。

{
  "mcpServers": {
    "i18n-agent": {
      "command": "node", 
      "args": ["/path/to/i18n-agent.js"],
      "env": {
        "MCP_SERVER_URL": "https://mcp.i18nagent.ai",
        "I18N_AGENT_API_KEY": "your-api-key-here"
      }
    }
  }
}

💡 使用上のヒント

翻訳のコンテキスト

• 対象読者: 「technical」、「casual」、「formal」、または「general」を指定します
• 業界のコンテキスト: 「technology」、「healthcare」、「finance」、「education」を使用します
• 地域による違い: 「Spain」、「Mexico」、「Brazil」などの地域を追加します

ファイルの翻訳

• 構造の保持: 元のファイル形式と構造を保持します
• 出力形式: 形式間で変換します（JSON ↔ YAML ↔ CSV）
• 大容量ファイル: 大容量ファイルは自動的に分割して処理します
• 非同期処理: 50KB を超えるファイルは、ジョブ追跡を伴う非同期処理で翻訳します
• 進捗状況の確認: 長時間かかる翻訳のステータスをリアルタイムで更新します
• タイムアウトへの対応: 大規模な翻訳ジョブでは最大 10 分間のタイムアウトを設定します

大規模な翻訳の処理

• 非同期処理: 100 件を超えるテキスト、または 50KB を超えるファイルは非同期で処理します
• ジョブ追跡: 長時間かかる翻訳を監視するための一意のジョブ ID を使用します
• 進捗状況の更新: 完了率とステータスをリアルタイムで表示します
• タイムアウトの延長: 5～10 分のタイムアウトにより中断を防ぎます
• 自動ポーリング: クライアントがジョブの完了を自動的にポーリングします

クレジット管理

• コスト: 1 語あたり 1 クレジット（1 語あたり $0.01）
• 残高の確認: 大規模な翻訳の前に残高を確認します
• 見積もり: 翻訳前に単語数の見積もりを取得します

品質に関する警告

• ソースの分析: デフォルトでは、翻訳前にソースコンテンツを分析し、品質上の問題を確認します
• 警告のスキップ: 自動化されたワークフローで警告を回避するには、skipWarnings: true を使用します
• トレードオフ: 警告をスキップすると、潜在的な問題に対処できず、翻訳品質が低下する可能性があります
• ベストプラクティス: 本番環境の翻訳では、警告を有効にしたままにしてください（デフォルト）

🚨 トラブルシューティング

インストールの問題

アクセスが拒否されました:

sudo npm install -g @i18n-agent/mcp-client

IDE が検出されません:

# Check if IDE directory exists
ls ~/Library/Application\ Support/Claude/
ls ~/.cursor/
ls ~/.vscode/

MCP 接続の問題

Claude Code でステータスが「Failed」になる場合：

Node バージョンマネージャー（nvm、fnm、n）でよく発生します。インストーラーは nvm を自動検出し、ラッパースクリプトを作成するようになりました。それでも問題が解決しない場合は、次の手順をお試しください。

1. Node のインストールを確認します：

   which node
   # If output contains .nvm, you're using nvm
   

2. 手動でラッパースクリプトを作成します（自動検出に失敗した場合）： ~/.claude/run-mcp.sh を作成します：

   #!/bin/bash
   export PATH="$(dirname $(which node)):$PATH"
   cd ~/.claude
   exec node node_modules/@i18n-agent/mcp-client/i18n-agent.js
   

   実行可能にします：

   chmod +x ~/.claude/run-mcp.sh
   

3. Claude の設定を更新します： ~/.claude.json を編集します：

   {
     "mcpServers": {
       "i18n-agent": {
         "command": "/Users/YOUR_USERNAME/.claude/run-mcp.sh",
         "env": {
           "MCP_SERVER_URL": "https://mcp.i18nagent.ai",
           "I18N_AGENT_API_KEY": "your-api-key"
         }
       }
     }
   }
   

4. Claude Code を完全に再起動します（ウィンドウを閉じるだけでなく、アプリを終了してください）

実行時の問題

API キーが見つからない場合：

echo $I18N_AGENT_API_KEY  # Should show your key
export I18N_AGENT_API_KEY=your-key-here

接続エラー：

• インターネット接続を確認してください
• API キーが有効であることを確認してください
• 数秒後にもう一度お試しください

翻訳品質：

• 本番環境では Tier 1 の言語を使用してください
• 業界や対象読者のパラメーターを指定して、コンテキストを追加してください
• Tier 2／3 の翻訳は手動で確認してください

📊 料金

• 従量課金制：単語あたり 1 クレジット（単語あたり $0.01）
• サブスクリプションなし：翻訳した分だけお支払いいただきます
• 大量利用割引：エンタープライズ利用向けにご用意しています
• 無料枠：新規アカウントには初回利用分のクレジットが付与されます

🔐 プライバシーとセキュリティ

• データを保存しません：翻訳はリアルタイムで処理されます
• 暗号化通信：すべてのデータは HTTPS 経由で送信されます
• API キーのセキュリティ：キーはローカルに保存され、ログに記録されることはありません
• GDPR に準拠：EU のプライバシー基準に準拠しています

🏗️ アーキテクチャ

MCP クライアントインストーラーは、確実にインストールできるモジュール式アーキテクチャを採用しています。

lib/
├── config-manager.js      # Config file operations with atomic writes
├── installer-core.js      # Installation orchestration
├── transport-detector.js  # Auto-detect SSE vs stdio transport
└── validator.js          # Input validation and sanitization

主な機能

• アトミックな設定の書き込み：一時ファイルと名前変更を使用して、クラッシュ時の安全性を確保します
• 自動バックアップ：変更前にタイムスタンプ付きのバックアップを作成します
• トランスポートの検出：設定から SSE と stdio を自動検出します
• 包括的な検証：モジュール境界ですべての入力を検証します
• 外部依存関係ゼロ：Node.js の組み込み機能のみを使用します

アーキテクチャの詳細

詳しいドキュメントをご覧ください：

• モジュールアーキテクチャ - モジュールの役割と設計
• アーキテクチャの完全ガイド - システム設計の全容

🤝 貢献

コントリビューションを歓迎します！コントリビューションガイドラインをご覧ください。

開発環境のセットアップ

git clone https://github.com/i18n-agent/mcp-client.git
cd mcp-client
npm install
npm test

公開

テストゲートが組み込まれた公開スクリプトを使用します：

./scripts/publish-mcp-client.sh --dry-run  # Preview package
./scripts/publish-mcp-client.sh            # Run pre-publish checks
npm publish                                 # Publish to npm

📝 ライセンス

MIT License — 詳細は LICENSE ファイルをご覧ください。

Copyright (c) 2025 FatCouple OÜ

🔗 リンク

• ウェブサイト：i18nagent.ai
• ダッシュボード：app.i18nagent.ai
• ドキュメント：docs.i18nagent.ai
• GitHub：github.com/i18n-agent/mcp-client
• 問題報告：github.com/i18n-agent/mcp-client/issues

🆘 サポート

• メール：[email protected]
• ドキュメント：docs.i18nagent.ai

🔧 利用可能な MCP ツール

translate_text

文化的な適応とコンテキスト認識を活用してテキストを翻訳します。

パラメーター：

• texts（array）：翻訳する文字列の配列
• targetLanguage（string）：翻訳先の言語コード
• targetAudience（string）：対象読者のコンテキスト
• industry（string）：業界のコンテキスト
• namespace（string、optional）：バックエンドでの追跡とプロジェクト整理に使用する任意の名前空間識別子
• sourceLanguage（string、optional）：原文の言語（指定がない場合は自動検出）
• region（string、optional）：ローカライズ対象の特定地域
• skipWarnings（boolean、optional）：原文の品質に関する警告をスキップします（デフォルト：false）。⚠️ WARNING：原文の分析を省略することで、翻訳品質が低下する可能性があります。コンテンツの品質に確信がある場合、または自動化されたワークフローでのみ使用してください。

translate_file

構造と形式を維持しながらファイルを翻訳します。

パラメーター：

• filePath または fileContent（string）：翻訳するファイルのパスまたはコンテンツ
• fileType（string）：ファイル形式（json、yaml、xml、csv、txt、md など）
• targetLanguage（string）：翻訳先の言語コード
• namespace（string、必須）：バックエンドでの追跡とプロジェクトの整理に使用する一意の名前空間識別子
• preserveKeys（boolean）：オブジェクトのキー／構造を維持するかどうか
• outputFormat（string）：出力形式（same、json、yaml、txt）
• skipWarnings（boolean、任意）：原文の品質に関する警告をスキップします（デフォルト：false）。⚠️ 警告：原文の分析を省略すると、翻訳品質が低下する可能性があります。コンテンツの品質に確信がある場合、または自動化されたワークフローでのみ使用してください。

analyze_content

翻訳前に、コンテンツの翻訳準備状況を分析し、改善案を取得します。翻訳にクレジットを費やす前に、潜在的な問題を特定し、コンテンツを最適化できます。

パラメーター：

• content（string/array/object）：分析するコンテンツ
• targetLanguage（string）：翻訳先の言語
• fileType（string、任意）：コンテンツがファイルに由来する場合のファイル形式
• sourceLanguage（string、任意）：原文の言語（自動検出）
• industry（string）：業界のコンテキスト
• targetAudience（string）：対象読者
• region（string、任意）：ローカライズする特定の地域

戻り値：

• 信頼度スコア付きの原文言語の検出結果
• コンテンツの種類とトーンの分析
• 翻訳準備状況スコア（0～100）
• 具体的な改善案
• 品質指標と問題点
• 潜在的な問題に関する警告
• 必要なクレジット数の推定

list_supported_languages

品質評価付きで、サポートされているすべての言語の一覧を取得します。

パラメーター：

• includeQuality（boolean）：品質評価を含めるかどうか（デフォルト：true）

get_credits

残りの翻訳クレジットと推定語数を確認します。

パラメーター：

• apiKey（string）：API キー

check_translation_status

非同期翻訳ジョブ（大きなファイルの場合）のステータスを確認します。

パラメーター：

• jobId（string）：非同期翻訳のジョブ ID

---

❤️ FatCouple OÜ によって作成されました