I18next Mcp Server

Name: I18next Mcp Server
Author: gtrias

本地服务

github.com/gtrias开发工具1270 周前更新

代码仓库

关于 I18next Mcp Server

用于管理 i18next 项目翻译文件的 MCP 服务，面向处理本地化代码的 AI 助手。它集成键管理、文件校验以及覆盖率和使用情况分析。

主要功能

01查看项目配置与统计信息
02查找并同步缺失键
03添加翻译键
04列出并校验翻译文件
05分析覆盖率、使用情况和质量
06导出翻译数据

适用场景

01检查不同语言的翻译完整性
02查找代码引用但缺失的键
03校验本地化 JSON 文件
04审查未使用键和翻译质量

MCP 相关

它向 MCP 客户端提供 i18next 项目信息、翻译文件操作和本地化分析工具。

#i18next #translations #l10n #mcp-server #ai-tools

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "i18next": {
      "command": "npx",
      "args": [
        "-y",
        "i18next-mcp-server"
      ],
      "env": {
        "I18N_PROJECT_ROOT": "<I18N_PROJECT_ROOT>",
        "I18N_LOCALES_PATH": "<I18N_LOCALES_PATH>",
        "I18N_DEFAULT_LANGUAGE": "<I18N_DEFAULT_LANGUAGE>",
        "I18N_SUPPORTED_LANGUAGES": "<I18N_SUPPORTED_LANGUAGES>"
      }
    }
  }
}

启动命令npx -y i18next-mcp-server

需要配置的环境变量

I18N_PROJECT_ROOT

I18N_LOCALES_PATH

I18N_DEFAULT_LANGUAGE

I18N_SUPPORTED_LANGUAGES

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmi18next-mcp-serverstdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

i18next MCP 服务

一个为 i18next 项目提供翻译管理功能的模型上下文协议（MCP）服务，让 Cursor 等 AI 助手能够直接与翻译文件交互。

🚀 快速设置

使用此 MCP 服务最简单的方式是通过 npx，无需安装：

npx i18next-mcp-server@latest --help

🔧 Cursor 配置

将以下内容添加到 Cursor MCP 设置中：

{
  "mcpServers": {
    "i18next-translation": {
      "command": "npx",
      "args": ["-y", "i18next-mcp-server@latest"],
      "env": {
        "I18N_PROJECT_ROOT": "/path/to/your/project",
        "I18N_LOCALES_PATH": "public/locales",
        "I18N_DEFAULT_LANGUAGE": "en",
        "I18N_SUPPORTED_LANGUAGES": "en,es,fr"
      }
    }
  }
}

如需详细的设置说明，请参阅 CURSOR_SETUP.md。

📁 预期项目结构

your-project/
├── public/locales/          # Translation files
│   ├── en/
│   │   ├── common.json
│   │   └── navigation.json
│   ├── es/
│   │   ├── common.json
│   │   └── navigation.json
│   └── ...
└── src/                     # Your source code

🛠️ 可用工具

核心工具

get_project_info - 获取项目配置和统计信息
health_check - 分析翻译文件的健康状况和完整性
scan_code_for_missing_keys - 查找代码中缺失的翻译键

键管理

add_translation_key - 添加新的翻译键
sync_missing_keys - 同步不同语言之间缺失的键
get_missing_keys - 按语言列出缺失的键

文件操作

list_files - 列出所有翻译文件
validate_files - 验证 JSON 语法
export_data - 将翻译导出为各种格式

分析

coverage_report - 翻译覆盖率统计
usage_analysis - 查找未使用的翻译键
quality_analysis - 分析翻译质量

🔧 环境变量

变量	描述	默认值
`I18N_PROJECT_ROOT`	项目根目录	当前目录
`I18N_LOCALES_PATH`	翻译文件路径	`public/locales`
`I18N_DEFAULT_LANGUAGE`	源语言	`en`
`I18N_SUPPORTED_LANGUAGES`	以逗号分隔的语言代码	`en`

🧪 开发

git clone https://github.com/gtrias/i18next-mcp-server.git
cd i18next-mcp-server
npm install
npm run build
npm test

📝 许可证

MIT 许可证 - 详情请参阅 LICENSE。

🔗 链接

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。