JSON Translations MCP Server

Name: JSON Translations MCP Server
Author: schmkls

@schmkls

Repository

About JSON Translations MCP Server

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.