Bluente翻訳MCPサーバー｜多言語翻訳AIを簡単にシステム統合できる開発者向けの業務効率化ツール

たんさく

Bluente Translate MCP Server

#null .JavaScript

スコア : 2ポイント

ダウンロード数 : 5.7K

更新時間 : 2026-06-17

サイトを開く

インストール

以下のコマンドをクライアントにコピーして設定

{
  "mcpServers": {
    "bluente-translate": {
      "command": "node",
      "args": ["/absolute/path/to/bluente-translate-mcp-server/src/index.js"],
      "env": {
        "BLUENTE_API_KEY": "your_api_key_here",
        "BLUENTE_API_BASE_URL": "https://api.bluente.com/api/20250924",
        "BLUENTE_API_TIMEOUT_MS": "90000"
      }
    }
  }
}

注意：あなたのキーは機密情報です。誰とも共有しないでください。

🚀 Bluente Translate MCP Server

AI 搭載・フォーマット保持・プロフェッショナル向けドキュメント翻訳ワークフローに最適

bluente-translate-mcp-server は、Bluente の翻訳機能を AI クライアントに公開するための公式オープンソース MCP サーバーです。

Bluente API を本番運用可能な MCP ツールとしてラップすることで、Claude Desktop、Cursor、その他の MCP 互換ランタイムから多言語ドキュメントワークフローを自動化できます。

🌟 Bluente を選ぶ理由

Bluente は、精度・フォーマットの完全性・スピードが重要となるエンタープライズグレードのドキュメント翻訳に注力しています。

Bluente.com および Blu Translate における製品のコアポジショニングは次のとおりです。

プロフェッショナルユースケース向けの AI 搭載翻訳
ドキュメント中心のワークフローにおける元レイアウトの保持
幅広い言語およびファイル形式のサポート
機密コンテンツに対するセキュリティファーストの取り扱い

本 MCP サーバーは、これらの機能を標準プロトコルインターフェースを通じてエージェントワークフローに統合します。

🏢 ブランドアイデンティティ

本リポジトリは Bluente によって維持されており、Bluente の公開開発者エコシステムの一部です。

企業ウェブサイト：https://www.bluente.com
製品ページ：https://www.bluente.com/translator
API ドキュメント：https://www.bluente.com/docs

📖 目次

提供機能
アーキテクチャ
対応 Bluente API
MCP ツール
クイックスタート
MCP クライアント連携
運用上の注意
セキュリティ
ロードマップ
コントリビューションとガバナンス
ライセンス

✨ 提供機能

明確なレイヤリング（config、client、service、tools）を持つモジュール型 Node.js MCP サーバー
保守性を高める 1 ツール 1 ファイルの実装
統一されたツールレスポンスエンベロープ（ok/tool/data および構造化エラー）
エンドツーエンドの翻訳ワークフローツール（アップロード → 開始 → ポーリング → ダウンロード）
CI チェックとローカルスモークテスト

🏗️ アーキテクチャ

AI Client (Claude / Cursor / Agents)
            |
            | MCP (stdio)
            v
+---------------------------------------+
| Bluente Translate MCP Server          |
|                                       |
|  tools/  -> MCP tool handlers         |
|  services/ -> workflow orchestration  |
|  clients/ -> Bluente HTTP API client  |
|  config/ + lib/ -> env/errors/results |
+---------------------------------------+
            |
            | HTTPS
            v
      Bluente Translation APIs

プロジェクト構成：

src/
  clients/bluente-http-client.js
  config/env.js
  constants/api.js
  lib/errors.js
  lib/mcp-result.js
  services/translation-workflow-service.js
  tools/*.tool.js
  tools/schemas.js
  tools/register-tools.js
  server.js
  index.js
tests/smoke/core-smoke.test.js

🔌 対応 Bluente API

GET /blu_translate/supported_languages
POST /blu_translate/upload_file
GET /blu_translate/get_translation_status
POST /blu_translate/translate_file
GET /blu_translate/download_file

参考：Bluente API Docs

🛠️ MCP ツール

bluente_get_supported_languages
bluente_upload_file
bluente_get_translation_status
bluente_translate_file
bluente_download_file
bluente_translate_document_workflow

ツールの挙動に関する注意：

bluente_translate_file：action="start" の場合は from と to が必須、action="cancel" の場合は任意です。
bluente_translate_document_workflow：ステータスポーリング用の status_entry は設定可能（pdf または word）です。

成功時のエンベロープ：

{
  "ok": true,
  "tool": "bluente_upload_file",
  "data": {
    "code": 0,
    "message": "success",
    "data": { "id": "task_xxx" }
  }
}

エラー時のエンベロープ：

{
  "isError": true,
  "ok": false,
  "tool": "bluente_translate_file",
  "error": {
    "name": "BluenteApiError",
    "message": "Bluente API request failed.",
    "details": { "status": 401 }
  }
}

🚀 クイックスタート

1. 要件

Node.js >= 20
Bluente API キー

2. インストール

npm install
cp .env.example .env

3. 設定

BLUENTE_API_KEY=your_api_key_here
BLUENTE_API_BASE_URL=https://api.bluente.com/api/20250924
BLUENTE_API_TIMEOUT_MS=90000

4. 実行

npm start

5. ローカルでの検証

npm run check
npm test

🔗 MCP クライアント連携

Claude Desktop の設定例：

{
  "mcpServers": {
    "bluente-translate": {
      "command": "node",
      "args": ["/absolute/path/to/bluente-translate-mcp-server/src/index.js"],
      "env": {
        "BLUENTE_API_KEY": "your_api_key_here",
        "BLUENTE_API_BASE_URL": "https://api.bluente.com/api/20250924",
        "BLUENTE_API_TIMEOUT_MS": "90000"
      }
    }
  }
}