@babelize/ mcp (英语)
用于 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 | 以贝贝为主机的翻译(免费; 创建密钥) (中文(简体) ). --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 设置按此顺序解决:
- CLI 参数数字 :
--api-key, (中文(简体) ),--api-url - 环境变量数字 :
BABELIZE_API_KEY, (中文(简体) ),BABELIZE_API_URL - 本地配置文件数字 :
.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_URL | API 基础 URL( 客户端附件) /api 页:1 | https://api.babelize.co |
--workspace 编号 : BABELIZE_WORKSPACE | 文件夹本地工具可能用于 | 客户端根, 否则是工作目录 |
设定
BABELIZE_API_URL仅指原产地 没有 包括/api后缀(例如:.http://localhost:3001),否则,请求将提交/api/api。 。 。 .
云工作流程示例
在一个命令中翻译 GitHub 工程
问你的人工智能经纪人:
"把我的项目翻译成法语和西班牙语"
经纪人会:
babelize_project_list找到你的项目babelize_project_language_add- 加法文+西班牙文babelize_run_and_wait- 开始+等待完成babelize_project_download——下载已翻译的ZIP
不使用 GitHub 翻译本地代码
"扫描我的本地项目 并将其翻译为德文"
babelize_scan—— 找到所有硬码字符串( 不需要 API 密钥)babelize_translate {to: ["de"]}——在您的机器上翻译并将结果写入工作树(不需要云项目)
对于一个没有 GitHub 的云项目,运行 babelize init --source zip 在项目目录中。 它将工程上传为ZIP. babelize_project_create 只创建 GitHub 工程 .
检查翻译质量
"审查我的工程翻译质量"
babelize_tm_get——检查翻译内存条目babelize_glossary_get- 审查术语统一性词汇表babelize_babel_get检查详细运行日志babelize_glossary_set· 增加缺少的术语表条目,以便进行一致的翻译
审计i18n准备状态
"扫描我的代码库 i18n问题。"
使用 babelize_analyze (当地,没有钥匙). 它涵盖了什么 babelize_scan 财务报告和审定财务报表 babelize_engine_analyze 并运行真正的提取和注射 干燥模式.