MCP Server for SimpleLocalize

SimpleLocalize 用 MCP サーバー

SimpleLocalize は、開発者を第一に考えた翻訳管理システムです。

これは、SimpleLocalize API と連携するためのツールを提供する Model Context Protocol（MCP） サーバーです。

セットアップ方法

mcp.json ファイルを設定し、'simplelocalize' を追加します。

{
  "mcpServers": {
    "simplelocalize": {
      "command": "npx",
      "args": [
        "-y",
        "@simplelocalize/simplelocalize-mcp",
        "--api-key=PROJECT_API_KEY"
      ]
    }
  }
}

機能（ツール）

翻訳キー

• 翻訳キーを取得
• 翻訳キーを作成
• 翻訳キーを更新
• 翻訳キーを削除
• 翻訳キーのスクリーンショットをアップロード（base64 またはファイル）

翻訳

• 翻訳を取得
• 翻訳を更新（単一および一括）

自動翻訳

• テキストを自動翻訳
• 自動翻訳ジョブを作成
• 自動翻訳ジョブを取得

タグ、言語、顧客

• タグを取得／作成／更新／削除
• 言語を取得／作成／更新／削除
• 顧客を取得／作成／更新／削除

ホスティングと公開

• ホスティング環境を取得／作成
• ホスティング環境の詳細を取得
• 翻訳をホスティング環境に公開

インポート、エクスポート、アクティビティ

• ローカルファイルから翻訳をインポート
• ダウンロード可能なファイルに翻訳をエクスポート
• 対応ファイル形式を取得
• プロジェクトのアクティビティを取得

用語集

• 用語集のエントリを取得
• 用語集のエントリを作成
• 用語集のエントリを削除

プロジェクト

• プロジェクトの詳細を取得

プルリクエストを作成するか、機能リクエストを作成して、ツールを追加できます。

インストール

MCP サーバーを使用するには、API キーが必要です。API キーは、SimpleLocalize > Settings > Credentials -> Project API Key で作成、管理できます。

Claude Desktop、Cursor、Windsurf などのクライアントでサーバーを実行するには、以下を MCP 設定に追加します。

{
  "servers": {
    "simplelocalize": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@simplelocalize/simplelocalize-mcp", "--api-key=SIMPLELOCALIZE_API_KEY"]
    }
  }
}

SIMPLELOCALIZE_API_KEY をご自身の API キーに置き換えてください。

詳しいセットアップガイドについては、以下をご覧ください。

• Cursor AI
• Visual Studio Code
• GitHub Copilot
• Claude Desktop
• Windsurf

開発

1. 依存関係をインストールします。

   pnpm install
   

2. サーバーをビルドします。

   pnpm build
   

3. クライアントがローカルビルドを使用するように更新します。

   {
     "servers": {
       "simplelocalize": {
         "command": "node",
         "args": ["path/to/simplelocalize-mcp-server/build/index.js"],
         "env": {
           "SIMPLELOCALIZE_API_KEY": "your_api_key"
         }
       }
     }
   }
   

デバッグ

MCP サーバーをデバッグするには、MCP Inspector ツールを使用できます。

1. Inspector を使ってサーバーを実行します。

   pnpm inspector
   

2. 表示された URL をブラウザーで開き、MCP のリクエストとレスポンスを確認してデバッグします。

3. --api-key 引数を指定します。

詳細情報

• SimpleLocalize 開発者向けドキュメント
• SimpleLocalize API リファレンス
• SimpleLocalize に登録