代理集成
设置 AI 编码代理（Cursor、Claude Code、Windsurf、GitHub Copilot、Codex）以自动处理本地化 — 包括原生的 MCP 集成。
概述
i1n 是专为代理时代构建的首个本地化工具。它在两个层面与 AI 编码代理集成：上下文规则用于教导代理您的项目的 i18n 约定，以及一个原生 MCP 服务器，允许代理直接执行 i1n 命令。
配置完成后，代理会自动使用翻译键而不是硬编码字符串，将键放在正确的命名空间文件中，保留插值变量，并且可以在不离开 IDE 的情况下进行推送、翻译和拉取。
上下文规则 (设置AI)
i1n 为 Cursor (.cursor/rules/i1n.mdc)、Claude Code (CLAUDE.md)、Windsurf (.windsurfrules)、GitHub Copilot (.github/copilot-instructions.md)、Codex (AGENTS.md) 和 Antigravity (.antigravity/rules.md) 生成上下文规则。
每个规则文件都针对代理的特定格式和功能进行了定制。运行 i1n setup-ai 一次性生成所有文件。
MCP服务器
i1n 包括一个原生的模型上下文协议 (MCP) 服务器，该服务器向 AI 编码助手公开 7 种工具。使用 i1n mcp 启动它，并配置您的编辑器进行连接。对于 Claude Code：claude mcp add i1n -- npx i1n mcp。对于 Cursor：添加到 .cursor/mcp.json。
可用的 MCP 工具：i1n_status（项目状态和限制）、i1n_push（推送本地文件）、i1n_pull（拉取翻译并生成类型）、i1n_translate（将内容翻译成指定语言）、i1n_add_language（添加新语言）、i1n_extract_and_translate（提取字符串、推送、翻译并一步生成类型），以及 i1n_search（查找现有翻译键）。
杀手级工作流：秒级国际化
最突出的功能是 i1n_extract_and_translate。告诉您的代理“国际化此组件” — 代理会读取文件，识别硬编码的字符串，使用提取的键值对调用 MCP 工具，i1n 会处理所有事情：推送密钥、翻译成所有活动语言以及重新生成 TypeScript 定义。然后，代理会使用 t() 调用重写您的代码。
一个传统上需要60分钟的任务——提取字符串、创建JSON条目、翻译、更新类型——现在只需30秒即可完成。此工作流程适用于Cursor、Claude Code、Windsurf以及任何MCP兼容的助手。
代理工作流
让您的代理执行诸如“添加一个包含通知偏好设置的设置页面。翻译成西班牙语和日语。”之类的任务。代理会创建带有正确翻译键的组件，然后使用 MCP 工具或运行 i1n push --translate es,ja。
整个本地化过程——从密钥创建到AI翻译——无需人工干预即可完成。此工作流程通过上下文规则和MCP集成，得到所有主要AI编码代理的支持。
i1n setup-ai
# Generates:
# .cursor/rules/i1n.mdc
# CLAUDE.md
# .windsurfrules
# .github/copilot-instructions.md
# AGENTS.md{
"mcpServers": {
"i1n": {
"command": "npx",
"args": ["i1n", "mcp"]
}
}
}