# @babelize/mcp 中文文档

规范地址：https://npmcn.com/package/%40babelize/mcp/

版本：1\.3\.14
npm 元数据更新时间：2026-11-01T20:51:05.110Z
中文译文更新时间：2026-11-07T17:57:03.898Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40babelize/mcp
原文对照：https://npmcn.com/package/%40babelize/mcp/?lang=original
项目主页：https://docs.babelize.co/integrations/mcp-server

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：330 kB，183 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：8 个
- 首次发布：2026-07-02T13:52:26.708Z
- 最新版本发布：2026-11-01T20:51:04.962Z
- 近 30 天下载量：3371（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：36（近 12 个月 36 个）

## 中文简介

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

## 安装

```sh
npm install @babelize/mcp
```

也可以使用：`pnpm add @babelize/mcp`、`yarn add @babelize/mcp`、`bun add @babelize/mcp`

## README

# @babelize/ mcp (英语)

[![Babelize MCP server](https://mcprush.com/badge/babelize-mcp/card.svg)](https://mcprush.com/to/babelize-mcp?ref=badge) [![Babelize MCP on mcprush](https://mcprush.com/badge/babelize-mcp/score.svg)](https://mcprush.com/to/babelize-mcp?ref=badge)

**用于 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_KEY` | OpenAI( 您的密钥) |
| `GEMINI_API_KEY` | 谷歌双子座( 您的密钥) |
| `GROQ_API_KEY` | 格鲁克(你的钥匙) |
| `OPENROUTER_API_KEY` | 打开路透( 您的密钥) |
| `BABELIZE_API_KEY` | 以贝贝为主机的翻译(免费; [创建密钥](https://app.babelize.co/api-keys)) (中文(简体) ). `--api-key` 或者说 `apiKey` 内 `.babelize/config.json` 工作: 云工具所用的同样密钥 |

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

## 设置

### 克劳德代码

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

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

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

### 光标

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

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

### 代码

`~/.codex/config.toml`数字 :

```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`。 。 。 .

```json
{
  "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` 检查 :

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

### 选项

| 选项/信封 | 说明 | 默认 |
| --- | --- | --- |
| `--api-key` 编号 : `BABELIZE_API_KEY` | 您的贝贝化 API 密钥 | —— 说 |
| `--api-url` 编号 : `BABELIZE_API_URL` | API 基础 URL( 客户端附件) `/api` 页:1 | `https://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` 并运行真正的提取和注射 干燥模式.

## 链接

-   [网站](https://babelize.co/)
-   [文档](https://docs.babelize.co/)
-   [无](https://www.npmjs.com/package/@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 和提交记录判断。