Bluente Translate MCP Server

Bluente翻译MCP服务器

AI驱动。格式保留。专为专业文档翻译工作流程而构建。

bluente-translate-mcp-server 是官方的开源MCP服务器，用于向AI客户端公开Bluente翻译功能。

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

为什么选择Bluente

Bluente专注于企业级文档翻译 准确性、格式完整性和速度 问题。

自 Bluente.com 网站 和 蓝光翻译，核心产品定位为：

• 基于人工智能的专业用例翻译
• 以文档为中心的工作流的原始布局保留
• 广泛的语言和文件类型支持
• 敏感内容的安全第一处理

此MCP服务器通过标准协议接口将这些功能引入代理工作流。

品牌识别

此存储库由以下人员维护 布朗特 是Bluente公共开发者生态系统的一部分。

• 公司网址： https://www.bluente.com
• 产品页面： https://www.bluente.com/translator
• API文件： https://www.bluente.com/docs

目录

• 所得
• 建筑
• 支持的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: from 和 to 当需要时 action="start" 在以下情况下可选 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"
      }
    }
  }
}

操作说明

• 工作流工具轮询直到终端状态(READY 或 ERROR).
• 输出下载可以通过以下方式禁用 auto_download=false.
• 超时可通过以下方式配置 BLUENTE_API_TIMEOUT_MS.
• 对于生产，每个环境使用单独的API密钥。

安全

• 不要提交API密钥或 .env 文件夹。
• 立即转动泄漏的钥匙。
• 使用存储库私有漏洞报告。

看 安全.md 披露政策。

路线图

• 如果在公共API文档中公开，则添加文本翻译工具
• 使用API mocking添加更丰富的集成测试
• 添加容器映像和一个命令本地启动配置文件

贡献与治理

• 贡献指南： 贡献.md
• 安全策略： 安全.md
• 变更日志： 更改日志.md
• 代码所有权：

关于Bluente

Bluente为专业团队构建人工智能翻译和商务沟通解决方案。

• 网站： 网站 bluente.com
• 产品页面： 蓝光翻译
• API文件： bluente.com/docs

许可证

麻省理工学院