English Français العربية

io.github.seigwen/dualtran-mcp

السجل الرسمي الذكاء الاصطناعي والوكلاء

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

متغيرات البيئة

  • DUALTRAN_PROVIDER AI provider id (openai, anthropic, google, deepseek, ...). Optional — Google works without a key.
  • DUALTRAN_API_KEY سري 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).

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو io.github.seigwen/dualtran-mcp؟

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

كيف أثبّت io.github.seigwen/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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.seigwen/dualtran-mcp إلى مفتاح API؟

نعم. يتطلب DUALTRAN_API_KEY، وتضبطها في إعداداته.

هل io.github.seigwen/dualtran-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.seigwen/dualtran-mcp؟

ينشره seigwen. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.