JSON Translations MCP Server

Name: JSON Translations MCP Server
Author: schmkls

@schmkls

代码仓库

关于 JSON Translations MCP Server

暂无概览

基本信息

分类

其他

许可证

MIT

运行时

node

传输方式

stdio

发布者

schmkls

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "JSON-translations-MCP-server": {
      "command": "bun",
      "args": [
        "run",
        "build"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is JSON Translations MCP Server?

A Model Context Protocol (MCP) server for updating and retrieving translations in JSON files. It provides two tools (update-translation and get-translation) that operate on nested translation structures using dot-notation keys. It is designed for developers managing multilingual translation files.

How to use JSON Translations MCP Server?

Install globally from npm (npm install -g json-translations-mcp-server) or build from source. Run the server with json-translations-mcp-server --path /path/to/translations (or -p). Invoke the update-translation or get-translation tools with parameters translationId (dot‑notation key), language, and optionally path. If a default path was set on startup, the path parameter can be omitted.

Key features of JSON Translations MCP Server

Update translations in JSON files using dot‑notation paths
Retrieve translations from JSON files using dot‑notation paths
Support for multiple language files
Preserves JSON structure and formatting
Handles nested translation keys
Graceful error handling
Optional default translations path

Use cases of JSON Translations MCP Server

Programmatically update and retrieve translations across language JSON files
Integrate translation management into MCP‑compatible assistants (e.g., Claude Desktop)
Maintain nested translation structures without manual file editing
Automate translation workflows in development and CI pipelines

FAQ from JSON Translations MCP Server

What tools does the server provide?

Two tools: update-translation and get-translation. Each accepts a translationId (dot‑notation key), a language code, and an optional path to the translation folder.

How do I specify the path to translation files?

You can set a default path when starting the server with the --path (or -p) argument. Alternatively, provide the path parameter in each tool call. If neither is provided, an error is returned.

How do I add this server to Claude Desktop?

Add an entry to your Claude Desktop configuration file under mcpServers with the command and args as shown in the README. You can use the globally installed binary or point to the built dist/main.js file.

What are the prerequisites?

Node.js or Bun is required to run the server.

Does the server support nested keys in JSON files?

Yes. Translation keys are specified using dot notation (e.g., "common.buttons.save"), and the server navigates the nested JSON structure accordingly.