AI 翻譯代理

將您的 AI 代理連接至 ai-l10n MCP 伺服器，即可將其轉變為專業的本地化工具。代理不再需要將原始 i18n 檔案內容貼入對話中，而是直接呼叫 l10n.dev 作為專屬翻譯引擎 — 確保格式正確、詞彙表持久化、風格指令自訂，並提供高效率的輸出。

為什麼要將您的 AI 代理連接至本地化 MCP？

傳統做法（將 i18n 檔案貼入對話中）很快就會遇到瓶頸。當您的代理使用專業本地化引擎時，會有以下改變：

• 大型檔案由伺服器端處理 — 代理無需將原始檔案內容載入其上下文視窗。
• 保證格式完整 — 佔位符、翻譯鍵及結構在翻譯後能完整保留，並在每次呼叫後進行驗證。
• 持久化詞彙表 — 關鍵術語在所有檔案、區塊及未來的對話中保持一致。
• 高效率 — 代理僅發送檔案路徑，僅回傳元數據。
• 增量翻譯 — 僅翻譯新增或變更的字串，保護您現有的翻譯。
• 生產就緒的輸出 — 無需事後編輯。

為您的 AI 代理提供專業本地化功能

ai-l10n MCP 伺服器增加了您的 AI 代理無法獨自實現的功能：

📖 AI 詞彙表產生

在翻譯前，要求代理從您的原文內容產生詞彙表。詞彙表會儲存至您的 l10n.dev 帳戶，並自動應用於後續的每個檔案與區塊 — 確保整個應用程式的術語始終保持一致。

✏️ 自訂風格與語氣規則

針對每個語言對建立語言指令 — 例如「使用非正式語氣，針對拉丁美洲西班牙語」或「品牌術語始終保持英文」。指令會儲存在您的帳戶中，並在每次翻譯呼叫時自動應用，無需在每次對話中重複說明。

💾 高效率翻譯

若無 MCP，翻譯大型 i18n 檔案意味著需將整個檔案載入代理的上下文視窗 — 既昂貴又常被截斷。透過 MCP，代理僅發送檔案路徑並僅接收元數據。整個翻譯過程在伺服器端完成，讓您的上下文視窗保持清空。

🛡️ 保證格式完整

伺服器會在每次翻譯後驗證輸出格式是否與原文相符 — 保留 JSON 結構、Flutter ARB 元數據、YAML 翻譯鍵、PO 目錄、XLIFF 區段以及所有佔位符語法。驗證會在結果回傳前於伺服器端完成。

⚡ 增量更新

啟用基於雜湊值的變更偵測，以跳過已翻譯的字串。僅發送新增或修改的字串進行翻譯，節省您的字元數配額，並防止現有翻譯被覆蓋。

快速入門

取得您的 API 金鑰

建立免費帳戶並在以下網址取得您的 API 金鑰：l10n.dev/ws/api-keys。您可以將金鑰設定為代理設定中的環境變數（如下所示），或要求您的代理使用 l10n_set_api_key 工具儲存一次 — 這會將其儲存至 ~/.ai-l10n/config.json 以供自動使用。

設定您的 AI 代理

在下方選擇您的代理並加入 MCP 伺服器設定。所有代理均使用相同的 npm 套件 — 僅設定格式有所不同。

Claude Desktop

開啟 Settings → Developer → Edit Config。Claude Desktop 將為您的安裝開啟正確的 MCP 設定檔。加入 l10n 伺服器區塊：

{
  "mcpServers": {
    "l10n": {
      "command": "npx",
      "args": ["-y", "ai-l10n-mcp"],
      "env": {
        "L10N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

在 Cursor 中開啟 Customize 以管理 MCP 伺服器，或手動加入設定。使用 ~/.cursor/mcp.json 進行全域設定，或在您的專案中使用 .cursor/mcp.json 進行工作區特定設定：

{
  "mcpServers": {
    "l10n": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ai-l10n-mcp"],
      "env": {
        "L10N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf

在 Cascade 中開啟 MCP 面板，或前往 Devin Settings → Cascade → MCP Servers。如需手動設定，請編輯 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "l10n": {
      "command": "npx",
      "args": ["-y", "ai-l10n-mcp"],
      "env": {
        "L10N_API_KEY": "your-api-key-here"
      }
    }
  }
}

GitHub Copilot (VS Code)

開啟指令面板並選擇 MCP: Open User Configuration，或在您的工作區中建立 .vscode/mcp.json 檔案：

{
  "servers": {
    "l10n": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ai-l10n-mcp"],
      "env": {
        "L10N_API_KEY": "your-api-key-here"
      }
    }
  }
}

OpenAI Codex

加入至 ~/.codex/config.toml 進行全域設定，或在受信任的專案中加入 .codex/config.toml：

[mcp_servers.l10n]
command = "npx"
args = ["-y", "ai-l10n-mcp"]

[mcp_servers.l10n.env]
L10N_API_KEY = "your-api-key-here"

或直接從終端機加入：

codex mcp add l10n --env L10N_API_KEY=your-api-key-here -- npx -y ai-l10n-mcp

Claude Code

從終端機加入伺服器。這適用於 CLI 與 VS Code 擴充功能：

claude mcp add --env L10N_API_KEY=your-api-key-here --transport stdio l10n -- npx -y ai-l10n-mcp

範例：使用 AI 代理翻譯您的應用程式

一旦連接 MCP，您的代理會在翻譯前主動檢查指令與詞彙表。當您說：「將我的應用程式翻譯成西班牙語和法語」時，典型的流程如下：

專案設定提示

MCP 包含內建的 l10n_project_setup 提示，可引導您的代理檢查並設定語言指令與詞彙表，以達到最佳翻譯品質。在每個新專案開始時或審核本地化設定時執行它。

「執行 l10n_project_setup 提示」或「為此專案設定 l10n.dev」

自動化設定提示

MCP 包含內建的 l10n_automation_setup 提示，可引導您的代理設定 i18n 檔案的自動翻譯。執行一次以設定未來所有提交的自動翻譯，無需手動觸發翻譯。

「執行 l10n_automation_setup 提示」或「為此專案設定自動本地化」

最佳實踐

• 使用詞彙表： 啟用詞彙表產生或使用現有詞彙表。要求 AI 將現有詞彙表加入您的專案。這能確保從第一次翻譯開始就保持術語一致性。
• 針對每種語言設定語氣指令： 不同市場有不同的期望。針對每個語言對設定指令 — 例如德語商業軟體使用正式語氣，西班牙語消費應用程式使用非正式語氣。
• 使用增量模式進行更新： 當目標檔案已存在時，請務必啟用增量翻譯。這能保護您目前的翻譯並節省您的字元數配額。
• 安全儲存您的 API 金鑰： 對於共享或 CI/CD 設定，請在代理的 MCP 設定中使用環境變數。對於個人使用，請要求代理使用 l10n_set_api_key 儲存一次。
• 使用專案設定提示： 在每個新專案開始時執行 l10n_project_setup，確保在翻譯前已設定好指令與詞彙表。
• 使用自動化設定提示： 減少手動工作並加速發佈。使用 ai-l10n CLI 或 VS Code 擴充功能自動翻譯您的 i18n 檔案。這消除了手動觸發翻譯的需求，並確保所有檔案的格式、詞彙表應用及風格指令保持一致。

準備好讓您的 AI 代理具備專業的本地化能力了嗎？