i18n Agent - AI Translation Management via MCP について
i18n Agent の翻訳ツールを AI 開発環境に導入するインストーラーです。文脈を踏まえたテキストやファイルの翻訳に対応し、ファイル構造も保持します。
主な機能
- 01MCP クライアントの導入と設定
- 02文脈に応じたテキスト翻訳
- 03構造を保ったファイル翻訳
- 04対応言語と品質評価の確認
活用シーン
- 01Claude Code、Gemini IDE、Cursor で翻訳を利用
- 02JSON、YAML、CSV、XML、Markdown のローカライズ
MCP 対応
i18n Agent の翻訳ツールを Claude Code、Gemini IDE、Cursor に接続するクライアントです。接続先からテキスト翻訳、ファイル翻訳、対応言語の一覧取得を呼び出せます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
@i18n-agent/mcp-client
AI 開発環境に i18n-agent MCP クライアントを簡単にインストールしてセットアップできます。
クイックスタート
お使いの AI 開発環境に MCP クライアントをインストールします。
Claude Code
npx @i18n-agent/mcp-client install --claude-code
Gemini IDE
npx @i18n-agent/mcp-client install --gemini
Cursor
npx @i18n-agent/mcp-client install --cursor
対話形式でのインストール
npx @i18n-agent/mcp-client install
インストール後に利用できる機能
インストールすると、お使いの AI 開発環境から以下の機能を利用できます。
- translate_text - 文化的背景や業界固有の用語を考慮してテキストを翻訳します
- translate_file - 構造を維持したままファイル全体を翻訳します(JSON、YAML、CSV、XML、Markdown など)
- list_supported_languages - 品質評価付きで、利用可能な言語ペアを確認します
使用例
インストール後は、以下のコマンドを AI アシスタントから直接使用できます。
"Translate this text to Spanish: Hello, how are you today?"
"Translate my en.json file to French"
"What languages are supported for translation?"
設定
API キーの設定
インストーラーでは、API キーを設定する方法を3 つ用意しています。
オプション 1:インストーラーの案内に従う(推奨)
npx @i18n-agent/mcp-client install --claude-code
インストーラーは以下を行います。
- API キーの取得先を表示します
- ブラウザーを自動的に開くかどうかを確認します
- セットアップ手順を案内します
- テスト用のデモキーを選択できるようにします
オプション 2:API キーを直接渡す
npx @i18n-agent/mcp-client install --claude-code --api-key sk-your-api-key-here
オプション 3:手早くテストするためにデモキーを使う
インストーラーでは、機能が制限されたデモキーを利用できます。自分のキーを取得する前に機能を試すのに最適です。
API キーの取得
- アクセス:app.i18nagent.ai
- サインアップ:アカウントを作成します
- API キーを取得:ダッシュボードからキーを取得します
- API キーをコピー:インストーラーで使用します
インストーラーからこのページを自動的に開くこともできます。
カスタムサーバー URL
エンタープライズ環境へのデプロイの場合:
npx @i18n-agent/mcp-client install --claude-code --server-url https://your-server.com
コマンド
インストール
IDE に MCP クライアントをインストールします。
npx @i18n-agent/mcp-client install [options]
オプション:
--claude-code- Claude Code CLI 用にインストールします--gemini- Gemini IDE 用にインストールします--cursor- Cursor IDE 用にインストールします--api-key <key>- API キーを設定します--server-url <url>- カスタムサーバー URL を設定します
ステータス
インストール状況を確認します。
npx @i18n-agent/mcp-client status
アンインストール
MCP クライアントの設定を削除します。
npx @i18n-agent/mcp-client uninstall [options]
対応 IDE
Claude Code ✅
ネイティブのツールサポートを備えた、完全な MCP 統合です。
Gemini IDE ⚡
AI アシスタント機能を備えた、拡張機能ベースの統合です。
Cursor ⚡
コマンドパレットと統合された VS Code 拡張機能です。
機能
- 🚀 ワンクリックインストール - 数秒で利用を開始できます
- 🌍 100 以上の言語 - 幅広い言語に対応しています
- 🎯 コンテキスト対応 - 業界や地域に特化した翻訳を提供します
- 📁 ファイル形式に対応 - JSON、YAML、CSV、XML、Markdown などに対応しています
- 🔒 安全 - エンタープライズレベルのセキュリティとデータ保護を提供します
- ⚡ 高速 - 開発者のワークフロー向けに最適化されています
トラブルシューティング
設定ファイル
インストーラーは、以下の場所に設定ファイルを作成します。
Claude Code:
- macOS:
~/Library/Application Support/claude-code/mcp_servers.json - Windows:
%APPDATA%\\claude-code\\mcp_servers.json - Linux:
~/.config/claude-code/mcp_servers.json
Gemini IDE:
- macOS:
~/Library/Application Support/gemini-ide/extensions.json - Windows:
%APPDATA%\\gemini-ide\\extensions.json - Linux:
~/.config/gemini-ide/extensions.json
Cursor:
- macOS:
~/Library/Application Support/Cursor/User/settings.json - Windows:
%APPDATA%\\Cursor\\User\\settings.json - Linux:
~/.config/Cursor/User/settings.json
よくある問題
- アクセスが拒否される:適切な権限で実行してください
- 設定が見つからない:IDE が正しくインストールされていることを確認してください
- API エラー:API キーとネットワーク接続を確認してください
サポート
- 📖 ドキュメント
- 🐛 問題を報告
- 💬 コミュニティサポート
ライセンス
MIT License - 詳細は LICENSE を参照してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。