MCP-Lingvanex-Translate Server

MCP プロトタイプ – 翻訳サーバー

このプロジェクトは、テキスト翻訳のための MCP (Model Context Protocol) サーバー を実装します。サーバーは2つのトランスポートをサポートします。

• stdio – Claude Desktop との統合用
• http (streamable) – HTTP + SSE 経由のテストおよび操作用

---

⚙️ 要件

• Node.js >= 18
• Yarn または npm
• インストール済みの Claude Desktop (stdio 統合用)
• テキスト翻訳用の Lingvanex Translator アカウント

---

🔑 Lingvanex Translator のセットアップ

Lingvanex Translator を使用するには、Lingvanex アカウントが必要です。

1. アカウントをお持ちでない場合は、無料でサインアップしてください
2. Cloud API タブに移動します: Cloud API
3. 請求先住所 データを入力します
4. 支払いに進む をクリックします
   • 無料トライアルを取得するために、支払いカードを追加する必要はありません
5. API キー が生成され、Cloud API タブに表示されます: API キー

これで翻訳 API の使用を開始する準備が整いました。以下は全体的なプロセスのビデオチュートリアルです (Lingvanex サイトで利用可能な場合)。

---

🚀 インストールとビルド

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

git clone https://github.com/lingvanex-mt/MCP-Lingvanex-Translate.git cd mcp-prototype

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

yarn install

---

🔌 stdio モードでの実行 (Claude Desktop)

stdio モードは、Claude Desktop がローカル MCP サーバーに接続するために使用されます。

環境変数を設定します:

TRANSPORT=stdio

サーバーを起動します:

yarn build yarn start

期待される出力:

MCP stdio transport running
Translate MCP Server ready

---

🌐 HTTP モードでの実行 (streamable)

http モードは、HTTP トランスポートでローカル HTTP サーバーを実行します。ブラウザテストや curl での使用に便利です。

環境変数を設定します:

TRANSPORT=http HTTP_PORT=3000

サーバーをテストします:

curl http://127.0.0.1:3000/ping

期待される応答:

{ "status": "ok", "transport": "http" }

デバッグに MCP Inspector を使用します:

npx @modelcontextprotocol/inspector

MCP Inspector UI で、トランスポートタイプ - Streamable HTTP を選択し、URL - http://localhost:3000/mcp. を入力して [接続] をクリックします。

---

🖥️ Claude Desktop との統合

Claude Desktop は、設定ファイルを介してローカル MCP サーバーを検出します。

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

設定例 (Windows)

claude_desktop_config.json を開く (または作成する) して、以下を追加します:

{ "mcpServers": { "translate": { "command": "node", "args": [ "C:\Users\path\to\project\dist\index.js" ] } } }

⚠️ ビルド後に、ローカルの dist/index.js へのパスを必ず更新してください！

---

✅ 検証方法

1. Claude Desktop を起動します。
2. 次のようなリクエストを入力します: "MCP ツール translatetext を使用して 'Hello world' をロシア語に翻訳してください。"
3. すべてが正しく設定されていれば、Claude が MCP サーバーを呼び出し、翻訳を返します。

---

📌 利用可能なツール

translate_text

テキストをある言語から別の言語に翻訳します。

引数:

• text – 翻訳するテキスト
• sourceLang – ソース言語コード (例: "en")
• targetLang – ターゲット言語コード (例: "ru")

リクエスト例:

{ "tool": "translate_text", "args": { "text": "Good morning", "sourceLang": "en", "targetLang": "fr" } }

応答例:

{ "content": [ { "type": "text", "text": "Bonjour" } ] }

---