MCP-Lingvanex-Translate

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 サイトで利用可能な場合)。

---

🚀 インストールとビルド

# Clone the repository
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

サーバーの起動:

yarn build
yarn start

サーバーのテスト:

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 ツール translate_text を使用して '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" }
  ]
}

---