JSON Translations MCP Server

JSON 翻訳 MCP サーバー

JSON ファイルの翻訳を更新・取得するための Model Context Protocol（MCP）サーバーです。

概要

この MCP サーバーは、update-translation と get-translation の 2 つのツールを提供します。これらのツールを使って、複数の言語の 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