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

Better i18n MCP（模型上下文协议）服务器让 AI 编程代理可以直接管理您的翻译。创建键、更新翻译、检查同步状态 — 全部通过 IDE 中的自然语言命令完成。

什么是 MCP？

MCP 是一种让 AI 代理与外部工具交互的协议。连接 Better i18n MCP 服务器后，您的 AI 代理可以：

• 列出和搜索翻译键
• 创建新键并赋值
• 更新翻译（跨语言）
• 检查同步状态并找到缺失的翻译
• 发布更改到 CDN
• 通过 Content SDK 管理内容

设置

Claude Code

添加到项目的 .mcp.json：

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

Cursor / Windsurf

添加到 IDE 的 MCP 设置（通常在设置 → MCP 服务器）：

{
  "better-i18n": {
    "command": "npx",
    "args": ["-y", "@better-i18n/mcp"],
    "env": {
      "BETTER_I18N_API_KEY": "sk_..."
    }
  }
}

注意： MCP 服务器请使用私钥（sk_...），而非公钥。MCP 服务器需要写入权限。

示例工作流

编码时添加键

您："我在添加一个设置页面。请用英文值创建 settings.title、
    settings.save_button 和 settings.cancel_button 的翻译键。"

代理：使用 createKeys 工具添加所有三个带值的键。

翻译

您："将 'settings' 命名空间中所有未翻译的键翻译成土耳其语。"

代理：使用 getTranslations 找出缺口，然后使用 proposeLanguageEdits
     添加土耳其语翻译。

检查状态

您："有没有缺少土耳其语翻译的键？"

代理：使用带语言过滤器的 listKeys 找出未翻译的键。

发布

您："发布所有待处理的翻译。"

代理：使用 publishTranslations 将更改推送到 CDN。

内容管理

还有一个独立的内容管理 MCP 服务器：

{
  "better-i18n-content": {
    "command": "npx",
    "args": ["-y", "@better-i18n/mcp-content"],
    "env": {
      "BETTER_I18N_API_KEY": "sk_..."
    }
  }
}

这可以管理结构化内容模型和条目 — 博客文章、更新日志、帮助文章等。

安全注意事项

• MCP 服务器在您的机器上本地运行
• 您的 API 密钥保留在本地环境中
• 代理只能在您项目权限范围内执行操作
• 所有更改均记录在控制台活动日志中

支持的代理

任何兼容 MCP 的代理均可使用，包括：

• Claude Code（CLI）
• Claude Desktop
• Cursor
• Windsurf
• Continue
• 使用 MCP SDK 构建的自定义代理

下一步

• MCP 文档
• AI 翻译质量