AI 本地化代理

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

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

傳統做法（將 i18n 檔案貼入對話）很容易失效。當您的代理改用專業本地化引擎時，將會有以下改變：

• 大型檔案於伺服器端處理——代理無需將原始檔案內容載入其脈絡視窗中。
• 保證格式完整——佔位符、鍵值與結構在翻譯後能原樣保留，並在每次呼叫後進行驗證。
• 永久詞彙表——關鍵術語在所有檔案、區塊及未來的對話中皆能保持一致。
• Token 使用效率高——代理僅需傳送檔案路徑；僅回傳中繼資料。
• 增量翻譯——僅翻譯新增或變更的字串，保護您現有的翻譯成果。
• 生產級輸出——無需進行後期編輯。

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

ai-l10n MCP 伺服器為您的 AI 代理增添了其自身無法複製的功能：

📖 AI 詞彙表生成

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

✏️ 自訂風格與語氣規則

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

💾 高效率 Token 翻譯

若無 MCP，翻譯大型 i18n 檔案意味著需將整個檔案載入代理的脈絡視窗——既昂貴又常被截斷。透過 MCP，代理僅傳送檔案路徑並接收中繼資料。整個翻譯過程皆在伺服器端處理，讓您的脈絡視窗保持清空。

🛡️ 保證格式完整

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

⚡ 增量更新

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

開始使用

取得您的 API 金鑰

建立免費帳戶並在以下網址取得您的 API 金鑰：l10n.dev/ws/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 中的 MCPs 面板，或前往 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 代理具備專業本地化能力了嗎？