@babelize/mcp

中文文档
1.3.14发布于 2026/11/02Apache-2.0ES Module近 30 天下载 3371

Babelize的MCP服务器:让AI编码代理分析,翻译,检查和审查你的应用程序与当地的 Babelize 引擎. mcprush.com-363 Ba77d1f63a2f91edcef68 (英语)

中文使用文档
文档目录25 节
  1. 当地工作流程
  2. 翻译密钥
  3. 设置
  4. 克劳德代码
  5. 光标
  6. 代码
  7. Claude 桌面、开放代码和其他客户端
  8. 示例提示
  9. 云项目管理工具
  10. 扫描( 低等, 不需要 API 密钥)
  11. 项目
  12. 翻译运行
  13. 语文
  14. 分析
  15. 翻译质量
  16. 团队部署( P)
  17. 账户
  18. 配置
  19. 选项
  20. 云工作流程示例
  21. 在一个命令中翻译 GitHub 工程
  22. 不使用 GitHub 翻译本地代码
  23. 检查翻译质量
  24. 审计i18n准备状态
  25. 链接

@babelize/ mcp (英语)

Babelize MCP server Babelize MCP on mcprush

用于 Babelize 的 MCP (模式上下文协议) 服务器 . 它让AI编码代理(Claude Code, Cursor, Codex, 或任何MCP客户端)从编辑器中让你的应用全局准备.

四个 本地工作流程工具 运行相同的 Babelize 引擎为 npx babelize translate在你的机器上 在你的工作树上 您不需要 Babelize 账户: 带上您自己的 LLM 密钥, 或使用 Babelize API 密钥进行主机翻译 。 年长者 云项目管理 关于bailize.co的项目仍然有工具可用.

当地工作流程

工具它会做什么需求
babelize_analyze本地化准备状态报告:框架与支持级别,i18n设置,硬码字符串(file:line),句子整体保持为ICU信息,无法被接通的字符串以及原因,硬码日期/曲线/平面,地域覆盖,未用密钥,后台阶. 以干燥模式运行在临时副本上.无
babelize_translate取出字符串,将其接通到 next-intl / reaction-i18next(缺少时添加配置和依赖性),翻译为目标地块,并将结果写入工作树. 通过锁文件递增,并附有进度通知.服务器内的一个密钥和一个干净的 git 树
babelize_check地语文件的QA:缺少, stale 或 空密钥; 未翻译值; 丢失或发明的占位符和标记; 无效的 ICU; 地语错误的复数格式; 词汇表违反.无
babelize_review相同的 QA, 仅限于 git diff (vs) 中改变的地块条目 HEAD 或一个 base 参考),外加未更新翻译的源字符串.基特还原

代理跟踪的环路是 分析 翻译 检查(或审查) 纠正 重复。React, Next.js, Django和静态 HTML 支持; Vue和React Introduct(Expo和光)在β中.

答复是紧凑的:简短摘要加上有上限清单的JSON一行(第1行)limit,默认 15)和与项目相对的路径. path 参数必须留在工作空间内。 工作空间是 --workspace 编号 : BABELIZE_WORKSPACE 如果设置了, 否则您的客户端会以 MCP 根显示文件夹, 否则服务器的工作目录将是一个工程( git repo 或 a) package.json) (中文(简体) ). / 您的家目录永远不会被使用. babelize_translate 每个项目一次运行一个.

翻译密钥

babelize_translate 从 MCP 服务器的环境。密钥从来不是工具参数,服务器从不打印它们.

新闻 var提供者
ANTHROPIC_API_KEY(你的钥匙)
OPENAI_API_KEYOpenAI( 您的密钥)
GEMINI_API_KEY谷歌双子座( 您的密钥)
GROQ_API_KEY格鲁克(你的钥匙)
OPENROUTER_API_KEY打开路透( 您的密钥)
BABELIZE_API_KEY以贝贝为主机的翻译(免费; 创建密钥) (中文(简体) ). --api-key 或者说 apiKey 内 .babelize/config.json 工作: 云工具所用的同样密钥

发现的第一个BYOK键胜出,然后是Babelize键. 一个特工可以直接选一个 provider (和 model 为BYOK.

设置

克劳德代码

claude mcp add babelize -e ANTHROPIC_API_KEY=sk-ant-... -- npx -y @babelize/mcp

或者和你的团队分享 .mcp.json 在回购. ${VAR} 从你的外壳中扩展,所以没有键被承诺:

{
  "mcpServers": {
    "babelize": {
      "command": "npx",
      "args": ["-y", "@babelize/mcp"],
      "env": { "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}" }
    }
  }
}

光标

.cursor/mcp.json (项目)或 ~/.cursor/mcp.json (全球):

{
  "mcpServers": {
    "babelize": {
      "command": "npx",
      "args": ["-y", "@babelize/mcp", "--workspace", "${workspaceFolder}"],
      "env": { "OPENAI_API_KEY": "${env:OPENAI_API_KEY}" }
    }
  }
}

代码

~/.codex/config.toml数字 :

[mcp_servers.babelize]
command = "npx"
args = ["-y", "@babelize/mcp"]
env = { ANTHROPIC_API_KEY = "sk-ant-..." }

如果本地工具报告错误文件夹, 请添加 "--workspace", "/path/to/your/app" 改为 args。 。 。 .

Claude 桌面、开放代码和其他客户端

运行 npx -y @babelize/mcp 作为stdio服务器,并设置了上方的密钥 Env vars之一. 如果客户端不启动您工程文件夹中的服务器( Claude Desktop 不启动) , 通过 --workspace /path/to/your/app。 。 。 .

{
  "mcpServers": {
    "babelize": {
      "command": "npx",
      "args": ["-y", "@babelize/mcp", "--workspace", "/path/to/your/app"],
      "env": { "GEMINI_API_KEY": "..." }
    }
  }
}

示例提示

用德文和日文使这个应用全球准备.

代理运行 babelize_analyze → babelize_translate {to: ["de","ja"]} → babelize_check,然后报告变化。 这个 make-global-ready MCP快取包含相同的指令.

如何将这个应用程序本地化? 不要改变任何东西.

babelize_analyze 报告什么翻译会提取和窃听,什么它不能。 要预览实际的 diff, 请使用 babelize_translate 与 dryRun: true (这个确实叫翻译).

我编辑了法国弦。 在我犯错之前有什么破损吗?

babelize_review 仅检查已更改的条目中丢失的占位符、 ICU 和复数错误、 未翻译文本和已过时的翻译 .

加韩文也.

babelize_translate {to: ["ko"]} 保持de/ja,而锁文件表示只有韩文翻译.

云项目管理工具

这些工具管理 babelize.co 上的工程,需要 Babelize API 键(BABELIZE_API_KEY, (中文(简体) ), --api-key 或者说 .babelize/config.json) (中文(简体) ). 这两个扫描工具是低级的帮助者,不需要钥匙.

扫描( 低等, 不需要 API 密钥)

工具说明
babelize_scan扫描硬编码字符串的本地目录
babelize_scan_strings从代码片断中提取可转换字符串

扫描字符串标记为 is_icu: true 当它们包含 ICU Message Format 语法({count, plural, ...}, (中文(简体) ), select, (中文(简体) ), selectordinal) (中文(简体) ).

项目

工具说明
babelize_project_list列出全部翻译项目
babelize_project_get获取具体项目的细节
babelize_project_create从 GitHub 仓库创建新翻译项目
babelize_project_language_add在工程中添加语言
babelize_project_language_remove从工程中删除语言
babelize_project_sync触发寄存器同步
babelize_project_download下载翻译为 ZIP 的项目文件

翻译运行

工具说明
babelize_run启动翻译管道运行
babelize_run_and_wait开始翻译运行并等待完成
babelize_status检查翻译运行的状态
babelize_babel_list列表翻译运行( 标签)
babelize_babel_get获取详细 Bail 运行信息和日志

语文

工具说明
babelize_language_list列出所有支持的语言
babelize_language_codes查看语言代码映射( ISO QQ FLORES- 200)

分析

工具说明
babelize_engine_analyze分析i18n准备状态和框架检测的源代码——接受内线 code 片段( 不需要复制)

翻译质量

工具说明
babelize_tm_get列出翻译内存条目(所有者范围——见下文注)
babelize_tm_set添加翻译内存条目
babelize_tm_export导出翻译内存为TMX
babelize_glossary_get列出项目词汇条目
babelize_glossary_set添加或更新术语表条目
babelize_glossary_delete删除词汇表条目
babelize_glossary_import从 CSV 从批量导入词汇条目
babelize_glossary_export导出词汇项为 CSV

翻译内存为所有者范围. 这个 babelize_tm_* 工具为 project_id 选择 API 路由,但所有者读取并写入其全部 内存,由它们拥有的所有项目共享(成员只看到 从属于的项目中输入).

团队部署( P)

工具说明
babelize_member_list列出项目成员名单
babelize_invitation_send发送团队邀请
babelize_pr_raise创建带有翻译的 GitHub Pull 请求( 当有翻译时将运行添加到打开的 PR 中); title, (中文(简体) ), base_branch, (中文(简体) ), force_new 可选)
babelize_pr_update将最近的运行推向项目打开的拉请求

账户

工具说明
babelize_me获取当前用户配置和信用
babelize_provider_tokens_list列出已连接的 BYOK 翻译提供者令牌

配置

云 API 设置按此顺序解决:

  1. CLI 参数数字 : --api-key, (中文(简体) ), --api-url
  2. 环境变量数字 : BABELIZE_API_KEY, (中文(简体) ), BABELIZE_API_URL
  3. 本地配置文件数字 : .babelize/config.json 在当前工作目录中

当地工具也读作 .babelize/config.json 在项目 sourceLocale 和任择词汇表,其中 babelize_translate 适用和 babelize_check 财务报告和审定财务报表 babelize_review 检查 :

{
  "sourceLocale": "en",
  "glossary": {
    "neverTranslate": ["Babelize"],
    "alwaysTranslateAs": [{ "term": "workspace", "translations": { "de": "Arbeitsbereich" } }]
  }
}

选项

选项/信封说明默认
--api-key 编号 : BABELIZE_API_KEY您的贝贝化 API 密钥—— 说
--api-url 编号 : BABELIZE_API_URLAPI 基础 URL( 客户端附件) /api 页:1https://api.babelize.co
--workspace 编号 : BABELIZE_WORKSPACE文件夹本地工具可能用于客户端根, 否则是工作目录

设定 BABELIZE_API_URL 仅指原产地 没有 包括 /api 后缀(例如:. http://localhost:3001),否则,请求将提交 /api/api。 。 。 .

云工作流程示例

在一个命令中翻译 GitHub 工程

问你的人工智能经纪人:

"把我的项目翻译成法语和西班牙语"

经纪人会:

  1. babelize_project_list 找到你的项目
  2. babelize_project_language_add - 加法文+西班牙文
  3. babelize_run_and_wait - 开始+等待完成
  4. babelize_project_download ——下载已翻译的ZIP

不使用 GitHub 翻译本地代码

"扫描我的本地项目 并将其翻译为德文"

  1. babelize_scan —— 找到所有硬码字符串( 不需要 API 密钥)
  2. babelize_translate {to: ["de"]} ——在您的机器上翻译并将结果写入工作树(不需要云项目)

对于一个没有 GitHub 的云项目,运行 babelize init --source zip 在项目目录中。 它将工程上传为ZIP. babelize_project_create 只创建 GitHub 工程 .

检查翻译质量

"审查我的工程翻译质量"

  1. babelize_tm_get ——检查翻译内存条目
  2. babelize_glossary_get - 审查术语统一性词汇表
  3. babelize_babel_get 检查详细运行日志
  4. babelize_glossary_set · 增加缺少的术语表条目,以便进行一致的翻译

审计i18n准备状态

"扫描我的代码库 i18n问题。"

使用 babelize_analyze (当地,没有钥匙). 它涵盖了什么 babelize_scan 财务报告和审定财务报表 babelize_engine_analyze 并运行真正的提取和注射 干燥模式.

版本与发布记录

@babelize/mcp 共发布 36 个版本,首次发布于 2026/07/02;过去 12 个月发布了 36 个版本。

版本发布日期距今
1.3.14latest2026/11/025 天前
1.3.132026/11/016 天前
1.3.122026/11/016 天前
1.3.112026/11/016 天前
1.3.102026/11/016 天前
1.3.92026/11/016 天前

关于 @babelize/mcp 的常见问题

@babelize/mcp 是什么?

Babelize的MCP服务器:让AI编码代理分析,翻译,检查和审查你的应用程序与当地的 Babelize 引擎. mcprush.com-363 Ba77d1f63a2f91edcef68 (英语)

如何安装 @babelize/mcp?

在项目目录运行 npm install @babelize/mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 babelize-mcp,可以用 npx babelize-mcp 直接运行。

@babelize/mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/babelize__mcp 是否存在。

@babelize/mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@babelize/mcp 可以商用吗?

@babelize/mcp 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@babelize/mcp 的下载量有多少?

根据 npm 官方下载统计,@babelize/mcp 在 2026/10/08 – 2026/11/06 这 30 天内被下载 3,371 次,日均约 112 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@babelize/mcp 还在维护吗?

最新版本 1.3.14 发布于 2026/11/02(5 天前);至今共发布 36 个版本,其中过去 12 个月发布了 36 个;首次发布于 2026/07/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。