Bluente翻译MCP服务器 - 多语言翻译AI集成工具

探索

Bluente Translate MCP Server

#null .JavaScript

评分 : 2分

下载量 : 6.7K

更新时间 : 2026-06-17

打开站点

安装

复制以下命令到你的Client进行配置

{
  "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 官方开源 MCP 服务器，用于向 AI 客户端开放 Bluente 翻译能力。

它将 Bluente API 封装为生产级 MCP 工具，让团队可以从 Claude Desktop、Cursor 以及其他兼容 MCP 的运行时中自动化多语言文档工作流。

🎯 为什么选择 Bluente

Bluente 专注于企业级文档翻译，尤其关注准确性、格式完整性和速度。

根据 Bluente.com 和 Blu Translate，核心产品定位如下：

面向专业用例的 AI 驱动翻译
面向以文档为中心的工作流保留原始版式
广泛的语言和文件类型支持
对敏感内容采用安全优先的处理方式

本 MCP 服务器通过标准协议接口，将这些能力引入智能体工作流。

🏷️ 品牌标识

本仓库由 Bluente 维护，是 Bluente 公共开发者生态的一部分。

📑 目录

✨ 你能获得什么
🏗️ 架构
🔌 支持的 Bluente API
🧰 MCP 工具
🚀 快速开始
🔗 MCP 客户端集成
📌 运维说明
🔐 安全
🗺️ 路线图
🤝 贡献与治理
📄 许可证

✨ 你能获得什么

模块化 Node.js MCP 服务器，分层清晰（config、client、service、tools）
每个工具一个文件，便于维护
统一的工具响应封装（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 文档

🧰 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"
      }
    }
  }
}