Lokalise MCP 连接 Gemini CLI

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Lokalise、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Lokalise + Gemini

通过 API v2 使用 Lokalise 翻译管理：带各语言进度的项目、带审校标记的键和翻译、语言、协作者、翻译和审校任务、以后台进程方式导出文件、评论、截图元数据、分支、自定义翻译状态和术语表。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

LOKALISE_API_TOKEN

步骤 1 — 获取凭证

设置大约需要 2 分钟。你需要一个能访问相关项目的 Lokalise 账户。

1. 在 Lokalise 中点击你的头像，打开 Profile settings > API tokens 并生成令牌。只读令牌足以使用读取工具；修改需要读写令牌。
2. 把它粘贴到 LOKALISE_API_TOKEN。它通过 X-Api-Token 请求头发送，在每个项目中以你的权限执行操作。
3. 安装连接器并运行 lokalise_list_projects，确认令牌可用。

Lokalise 自己的 MCP 服务器：Lokalise 也提供测试版 MCP 服务器（https://mcp.lokalise.com/mcp/project-management 和 /mcp/software-development，使用 OAuth 或 apikey 请求头）。这个连接器使用 API v2 和你的令牌。

读取的内容：

• 项目，包括类型、基础语言和团队；加上 include_statistics: 1 还会返回各语言的进度、键数、词数和 QA 问题。项目语言、Lokalise 支持的所有语言及其 ISO 代码和复数形式，以及自定义翻译状态。
• 键，包括各平台的名称、描述、标签、文件名、上下文、字符限制，加上 include_translations: 1 还会返回其文本。筛选条件：键名、标签、文件名、平台、未翻译、QA 问题或已归档。
• 翻译，每个键和语言一行，可按语言、已审校、未确认、未翻译、QA 问题或进行中的任务筛选。
• 协作者及其权限和语言；lokalise_get_my_contributor 返回令牌所有者，写入都以此人的名义进行。
• 任务，包括类型、状态、截止日期、语言、负责人和进度；文件，包括键数和最近一次导入；按项目或按键的评论；带关联键的截图元数据；分支；带翻译、标签和标记的术语表术语。

写入的内容：

• lokalise_create_keys 添加新字符串及其平台和源文本。lokalise_update_key 和 lokalise_bulk_update_keys 修改名称、描述、标签（merge_tags 表示追加而不是替换）、平台、文件名、上下文、字符限制和翻译。
• lokalise_update_translation 修改一条文本及其已审校、未确认或自定义状态标记。复数键接受包含各形式（one、other 等）的 JSON 字符串。
• 按 ISO 代码添加语言的 lokalise_add_languages；会发送邀请邮件的 lokalise_add_contributors；lokalise_create_task 为部分键和语言创建 translation、review 或 automatic_translation 任务，并带截止日期分配给用户或用户组；lokalise_update_task，其中 {"close_task": true} 会关闭任务。
• lokalise_add_key_comments（向译者提问或为字符串补充上下文）、lokalise_create_branch、lokalise_create_glossary_terms（例如不得翻译的品牌名或禁用词）和 lokalise_update_glossary_terms。

文件导出：lokalise_download_files 以 json、xliff、strings、xml、po 或 yaml 等格式开始导出，并返回 process_id。AI 会反复调用 lokalise_get_process，直到 status 为 finished，再把 details.download_url 的 zip 链接交给你，该链接一段时间后会失效。导出虽然是 POST，但不会修改项目。

安装时关闭：lokalise_delete_key，它会删除一个键及其全部翻译，且无法撤销。由工作区管理员在团队需要时开启。

ID 和格式：项目 ID 形如 767946315e9866d013c1d0.08299127；要在分支上操作，请传入 <project id>:<branch name>。键、翻译、任务、语言和用户的 ID 都是数字。语言使用 en、de 或 pt_BR 等 ISO 代码。列表响应会把条目包在一层里（projects、keys、translations 等）。时间以 YYYY-MM-DD HH:MM:SS (Etc/UTC) 加 Unix ..._timestamp 的形式返回。筛选中的标记为 0 或 1。

分页：使用 limit 和 page；总数在 x-pagination-total-count 和 x-pagination-page-count 响应头中返回，显示在 _headers 下。键和翻译也支持 pagination: cursor：AI 把 x-pagination-next-cursor 的值作为 cursor 传入，直到它不再出现。术语表术语只用 cursor 分页。

限制：每个令牌和每个 IP 地址每秒 6 个请求，每个项目最多 10 个并发请求；429 表示需要放慢。

常见错误：401 表示令牌错误。403 表示用只读令牌执行了写入，或在项目中缺少权限。404 表示项目或条目不存在。400 是会指出字段的校验错误；当 X-Api-Token 的值不是有效令牌（例如带有空格或引号）时也会出现。

该连接器不会上传翻译文件（需要 base64 内容）或截图，也不会删除项目、语言、任务或术语表术语。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 Lokalise 的工具。

可用工具

示例提示

• “移动应用项目各语言的翻译进度如何？”
• “带 checkout 标签的键中，哪些还没有翻译成德语和法语？”
• “把 Web 项目导出为 de 和 it 的 JSON 文件，并给我下载链接。”
• “为入门引导键的西班牙语翻译创建一个审校任务，截止日期是下周五。”
• “把“AnythingMCP”作为不得翻译的品牌名添加到术语表。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Meta Muse
• 连接到 Microsoft Copilot