bluente-translate

Translate your documents with formatting intact in 2 minutes

AI-powered. Format-preserving. Built for professional document translation workflows.

bluente-translate-mcp-serveris the official open-source MCP server for exposing Bluente translation capabilities to AI clients.

It wraps Bluente APIs into production-ready MCP tools so teams can automate multilingual document workflows from Claude Desktop, Cursor, and other MCP-compatible runtimes.

Bluente focuses on enterprise-grade document translation whereaccuracy, formatting integrity, and speedmatter.

FromBluente.comandBlu Translate, the core product positioning is:

- Company website:https://www.bluente.com
- Product page:https://www.bluente.com/translator
- API docs:https://www.bluente.com/docs

- What You Get
- Architecture
- Supported Bluente APIs
- MCP Tools
- Quick Start
- Local Development
- Operational Notes
- Data Handling & Privacy
- Security
- Roadmap
- Contributing and Governance
- License

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

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

{ "mcpServers": { "bluente-translate": { "command": "npx", "args": ["-y", "@bluente/translate-mcp-server"], "env": { "BLUENTE_API_KEY": "your_api_key_here" } } } }

Quit and reopen Claude Desktop. The tools icon should list sixbluente_tools.

Claude Code— one command, then restart your session and verify with/mcp:

claude mcp add bluente-translate -e BLUENTE_API_KEY=your_api_key_here -- npx -y @bluente/translate-mcp-server

Cursor— Settings → MCP → Add server, or create.cursor/mcp.jsonin your project with the same JSON block as Claude Desktop.

Smoke test (any client):ask"What languages does Bluente translation support?"— a free, read-only call. A language list back means the key and connection both work. The first run takes a few extra seconds whilenpxdownloads the package.

The server readsBLUENTE_API_KEYfrom its environment — you never pass it as a tool argument or store it in a file. If the server reportsMissing BLUENTE_API_KEY, the key is not reaching the server process: check theenvblock for typos and restart your client. When testing from a terminal, prefix the server command itself (BLUENTE_API_KEY=your_api_key_here npx -y @bluente/translate-mcp-server); in a shell pipeline the assignment must sit directly beforenpx— placed at the start of the line it applies only to the first command in the pipe.

git clone https://github.com/bluente/bluente-translate-mcp-server.git cd bluente-translate-mcp-server npm install cp .env.example .env # then set BLUENTE_API_KEY npm start # run the server on stdio npm run check # syntax check npm test # run tests

To point an MCP client at your local checkout, use"command": "node"with"args": ["/absolute/path/to/bluente-translate-mcp-server/src/index.js"]instead of thenpxconfig above.

- Workflow tool polls until terminal state (READYorERROR).
- Output download can be disabled withauto_download=false.
- Timeout is configurable viaBLUENTE_API_TIMEOUT_MS.
- For production, use separate API keys per environment.

- Documents you translate are uploaded to Bluente's API(api.bluente.comby default) for processing. Do not translate documents you are not permitted to send to a third-party service.
- The AI model controls the tools.When run locally (stdio),file_pathlets the model read any file your user account can read and upload it to Bluente, andoutput_pathlets it write downloaded files to any writable path. Review tool calls in your MCP client before approving them, especially when working with untrusted documents — a malicious document could try to instruct the model to misuse these tools.
- Translated output returned by tools (file contents, status payloads) enters your AI client's context and is therefore visible to your LLM provider.
- Your API key stays on your machine: it is read from the environment and sent only as anAuthorizationheader to the configured Bluente API base URL. It is never logged or included in tool responses.

- Do not commit API keys or.envfiles.
- Rotate leaked keys immediately.
- Use repository private vulnerability reporting.

- Add text translation tools if exposed in public API docs
- Add richer integration tests with API mocking
- Add container image and one-command local launch profile

- Contribution guide:CONTRIBUTING.md
- Security policy:SECURITY.md
- Changelog:CHANGELOG.md
- Code ownership:.github/CODEOWNERS

- Website:bluente.com
- Product page:Blu Translate
- API documentation:bluente.com/docs

Kamai is an AI takeoff platform that reads your construction blueprints and instantly extracts the quantities, measurements, and materials you need to estimate and bid jobs faster.