JSON Translations MCP Server

JSON 翻译 MCP 服务

一个用于更新和获取 JSON 文件中翻译内容的模型上下文协议（MCP）服务。

概述

此 MCP 服务提供两个工具：update-translation 和 get-translation。这些工具可用于更新和获取不同语言的 JSON 文件中的翻译内容。它旨在处理嵌套翻译结构，其中键以点号分隔。

功能

• 使用点号表示法路径更新 JSON 文件中的翻译
• 使用点号表示法路径获取 JSON 文件中的翻译
• 支持多个语言文件
• 保留 JSON 结构和格式
• 处理嵌套翻译键
• 优雅地处理错误
• 可选的默认翻译路径

工具：update-translation

参数

• translationId - 使用点号表示法的翻译 ID（例如："common.buttons.save"）
• language - 翻译文件的语言代码（例如："sv"、"en"、……）
• path - （可选）包含翻译文件的文件夹路径。如果未提供，则使用服务初始化时设置的默认路径。
• translation - 要插入的新翻译值

示例

{
  "translationId": "common.buttons.save",
  "language": "en",
  "translation": "Save"
}

工具：get-translation

参数

• translationId - 使用点号表示法的翻译 ID（例如："homepage.welcome.message"）
• language - 翻译文件的语言代码（例如："sv"、"en"、……）
• path - （可选）包含翻译文件的文件夹路径。如果未提供，则使用服务初始化时设置的默认路径。

示例

{
  "translationId": "homepage.welcome.message",
  "language": "en"
}

设置和使用

前提条件

• Node.js 或 Bun

安装

从 npm 安装

npm install -g json-translations-mcp-server

从源代码安装

1. 克隆代码库
2. 安装依赖项：

bun install
# or
npm install

构建

bun run build
# or
npm run build

运行

# If installed from npm globally
json-translations-mcp-server --path /path/to/translations
# or
json-translations-mcp-server -p /path/to/translations

# If running from source
bun start --path /path/to/translations
# or
npm run start -- --path /path/to/translations

开发

测试

bun test

项目结构

json-translations-mcp-server/
├── src/
│   ├── main.ts                         # Server entry point
│   └── tools/
│       ├── updateTranslation/
│       │   ├── index.ts                # Tool implementation
│       │   └── schema.ts               # Tool schema
│       └── getTranslation/
│           ├── index.ts                # Tool implementation
│           └── schema.ts               # Tool schema
├── tests/                              # Test files
├── biome.json                          # Linting configuration
├── tsconfig.json                       # TypeScript configuration
└── package.json                        # Project dependencies

添加到 Claude Desktop

将 MCP 服务添加到 Claude Desktop：

如果从 npm 安装

{
  "mcpServers": {
    "json-translations-mcp-server": {
      "command": "json-translations-mcp-server",
      "args": ["--path", "/path/to/translations"]
    }
  }
}

如果从源代码使用

1. 构建项目：

   bun run build
   

2. 使用默认路径添加到 Claude Desktop 配置：

   {
     "mcpServers": {
       "json-translations-mcp-server": {
         "command": "bun",
         "args": [
           "/path/to/your/project/dist/main.js",
           "--path",
           "/path/to/translations"
         ]
       }
     }
   }
   

3. 或不设置默认路径（每次调用工具时都需要提供路径）：

   {
     "mcpServers": {
       "json-translations-mcp-server": {
         "command": "bun",
         "args": ["/path/to/your/project/dist/main.js"]
       }
     }
   }
   

许可证

MIT