JSON Translations MCP Server

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.