English Français العربية

io.github.seigwen/dualtran-mcp

Official registry AI and agents

Translate text with Google or your own AI model (BYOK, 20+ providers) from any MCP client.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package dualtran-mcp
Claude Code 
claude mcp add dualtran-mcp -e 'DUALTRAN_PROVIDER=<DUALTRAN_PROVIDER>' -e 'DUALTRAN_API_KEY=<your dualtran_api_key>' -e 'DUALTRAN_MODEL=<DUALTRAN_MODEL>' -e 'DUALTRAN_TARGET_LANG=<DUALTRAN_TARGET_LANG>' -- npx -y dualtran-mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "dualtran-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "dualtran-mcp@0.1.0"
            ],
            "env": {
                "DUALTRAN_PROVIDER": "<DUALTRAN_PROVIDER>",
                "DUALTRAN_API_KEY": "<your dualtran_api_key>",
                "DUALTRAN_MODEL": "<DUALTRAN_MODEL>",
                "DUALTRAN_TARGET_LANG": "<DUALTRAN_TARGET_LANG>"
            }
        }
    }
}

Environment variables

  • DUALTRAN_PROVIDER AI provider id (openai, anthropic, google, deepseek, ...). Optional — Google works without a key.
  • DUALTRAN_API_KEY secret API key for the selected AI provider (BYOK). Optional.
  • DUALTRAN_MODEL Model id for the AI provider (e.g. gpt-4o-mini). Optional.
  • DUALTRAN_TARGET_LANG Default target language code (default: en).

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. dualtran-mcp
  2. Tools
  3. Install
  4. Configure
  5. Client configuration
  6. Privacy
  7. Development
  8. License

dualtran-mcp

An MCP (Model Context Protocol) server that translates text with Google or your own AI model (BYOK, 20+ providers) — usable from Claude Code, Claude Desktop, Cursor, Cline, VS Code and any other MCP client. Powered by @dualtran/core, the engine extracted from the DualTran browser extension.

Tools

ToolWhat it does
translate_textTranslate one piece of text. Optional target_lang, source_lang, engine (google \ai).
translate_batchTranslate up to 50 texts in one call (one batched Google request).
list_enginesReport available engines and the AI configuration state (never the key).

Install

npx -y dualtran-mcp
# or straight from this repository (works today, no registry needed):
npx -y github:seigwen/dualtran-mcp

Configure

Google works out of the box — no key, no account.

For the AI engine (optional), configure a provider once — either with environment variables:

DUALTRAN_PROVIDER=openai        # openai | anthropic | google | deepseek | mistral | groq | xai | …
DUALTRAN_API_KEY=sk-…
DUALTRAN_MODEL=gpt-4o-mini
DUALTRAN_BASE_URL=              # optional endpoint override
DUALTRAN_TARGET_LANG=en         # default target language
DUALTRAN_ENGINE=google          # default engine: google | ai

or with ~/.dualtran/config.json:

{ "provider": "openai", "apiKey": "sk-…", "model": "gpt-4o-mini", "targetLang": "en", "engine": "ai" }

Environment variables win over the file.

Client configuration

Claude Code (.mcp.json in the project, or claude mcp add):

{
  "mcpServers": {
    "dualtran": {
      "command": "npx",
      "args": ["-y", "github:seigwen/dualtran-mcp"],
      "env": { "DUALTRAN_TARGET_LANG": "en" }
    }
  }
}

Cursor (~/.cursor/mcp.json) and Cline / other clients: same shape — command: npx, args: ["-y", "github:seigwen/dualtran-mcp"], optional env.

Privacy

No analytics, no accounts, no developer server. Text goes only to the translation service you chose, at the moment you translate. See PRIVACY.md.

Development

node scripts/sync-core.mjs   # vendors @dualtran/core into vendor/ (committed)
npm install
npm test                     # tsc build + vitest (in-memory server, real stdio e2e, stdout purity scan)

License

MIT — the bundled @dualtran/core portion is MPL-2.0.

Frequently asked questions

What is io.github.seigwen/dualtran-mcp?

Translate text with Google or your own AI model (BYOK, 20+ providers) from any MCP client.

How do I install io.github.seigwen/dualtran-mcp?

It runs on your machine. In Claude Code: claude mcp add dualtran-mcp -e 'DUALTRAN_PROVIDER=<DUALTRAN_PROVIDER>' -e 'DUALTRAN_API_KEY=<your dualtran_api_key>' -e 'DUALTRAN_MODEL=<DUALTRAN_MODEL>' -e 'DUALTRAN_TARGET_LANG=<DUALTRAN_TARGET_LANG>' -- npx -y dualtran-mcp@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.seigwen/dualtran-mcp need an API key?

Yes. It expects DUALTRAN_API_KEY, which you set in its configuration.

Is io.github.seigwen/dualtran-mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.seigwen/dualtran-mcp?

It is published by seigwen. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.