如何将 MCP 服务器与 AI 编程代理配合使用？

Better i18n MCP（模型上下文协议）服务器让 Claude Code、Cursor 等 AI 编程代理能够直接管理您的翻译 — 创建键、翻译内容、发布，以及管理内容条目。

安装 MCP 服务器

npx @better-i18n/mcp

或将其添加到您的 MCP 配置文件：

{
  "mcpServers": {
    "better-i18n": {
      "command": "npx",
      "args": ["-y", "@better-i18n/mcp"],
      "env": {
        "BETTER_I18N_API_KEY": "sk_您的密钥"
      }
    }
  }
}

可用工具

翻译键管理

工具	功能
listProjects	列出所有项目
getProject	获取项目详情（语言、键数量）
listKeys	通过筛选器浏览翻译键
createKeys	创建带值的新翻译键
updateKeys	更新现有键或添加翻译
deleteKeys	从项目中删除键
publishTranslations	将翻译推送到 CDN

内容 CMS

工具	功能
listContentModels	列出内容模型 schema
getContentEntry	获取包含所有翻译的条目
listContentEntries	通过筛选器列出条目
createContentEntry	创建新条目（一次性包含所有语言）
updateContentEntry	更新现有条目
bulkUpdateEntries	一次调用更新最多 20 个条目
bulkCreateEntries	一次创建多个条目
publishContentEntry	将条目发布到 CDN

代理提示词示例

"添加翻译键 common.save_button，值为 'Save'，并翻译成土耳其语、法语和西班牙语"

"找出 'auth' 命名空间中所有未翻译的键，并将其翻译成德语"

"创建一篇关于 Better i18n 入门的帮助文章，翻译成项目所有语言并发布"

"检查所有键是否与代码库同步，并修复缺失的键"

身份验证

MCP 服务器使用您的密钥（sk_...）。请妥善保管 — 不要提交到 git。

对于 Claude Code，将密钥添加到 .claude/settings.json 的 env 下。

对于 Cursor，将其添加到 MCP 设置的 env 下。

代理能做和不能做的事

使用 MCP 服务器的代理可以：

• 创建、读取、更新、删除翻译键
• 使用 AI 翻译内容
• 管理内容条目和模型
• 发布到生产 CDN

代理不能：

• 访问计费或付款设置
• 删除项目或组织
• 邀请团队成员
• 访问其他用户的私有数据

记录 MCP 活动

所有 MCP 操作都会以「代理」标签记录在项目的活动日志中，便于您查看 AI 的操作历史。