localizely-mcp

Localizely 用の MCP サーバー — 自然言語で、MCP 互換クライアント (Claude Desktop、Claude Code、Cursor など) から翻訳ファイル (Flutter ARB、iOS .strings、Android XML、JSON など) を管理できます。

ツール

対応ファイル形式: flutter_arb, json, android_xml, ios_strings, ios_stringsdict, java_properties, rails_yaml, angular_xlf, dotnet_resx, po, pot, csv, xlsx。

Localizely API は文字列単位の CRUD を公開していません。一括操作はファイルのアップロード/ダウンロードを介して行います。localizely_update_key は、単発の編集のために内部で小さな単一キーのファイルを構築します。

Related MCP server: tolgee-mcp

必要条件

• Python 3.10+

• Localizely アカウントとプロジェクト

• Localizely のプライベート API キー — アカウント設定 → API キー → https://app.localizely.com/settings/api-keys

• uv がインストールされていること (uvx に同梱) — 推奨。ローカルへのクローンや venv は不要

このパッケージは PyPI には公開されていません。uv の git サポートを介してこの公開 GitHub リポジトリから直接実行されます。別途デプロイや公開の手順は必要ありません。

使用方法

Claude Desktop / Claude Code — 推奨 (uvx、クローン不要)

MCP 設定 (claude_desktop_config.json または .mcp.json) に追加します:

{
  "mcpServers": {
    "localizely": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/adborroto/localizely-mcp", "localizely-mcp"],
      "env": {
        "LOCALIZELY_API_TOKEN": "your-api-token",
        "LOCALIZELY_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

uvx はリポジトリを取得し、分離された環境を構築して、必要に応じて localizely-mcp エントリポイントを実行します。手動でインストールや更新を行う必要はありません。安定性のために git+https://github.com/adborroto/localizely-mcp@<tag-or-sha> で特定のコミット/タグを固定できます。

設定を編集したらクライアントを再起動してください。

ローカルクローン (代替)

git clone https://github.com/adborroto/localizely-mcp.git
cd localizely-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install .

cp .env.example .env
# edit .env and set LOCALIZELY_API_TOKEN

次に、MCP 設定で venv の Python を直接指定します:

{
  "mcpServers": {
    "localizely": {
      "command": "/absolute/path/to/localizely-mcp/.venv/bin/localizely-mcp",
      "env": {
        "LOCALIZELY_API_TOKEN": "your-api-token",
        "LOCALIZELY_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

サーバーは MCP プロトコルが想定するように stdio で通信します。対話的に実行することを想定していません。

プロジェクト ID の確認

すべてのツールは project_id を受け取ります。Localizely Web アプリの マイプロジェクト ページで確認できます。プロジェクト URL またはプロジェクト設定内の UUID です。

主に単一のプロジェクトで作業する場合は、毎回 project_id を渡す代わりに、環境変数 (または MCP 設定の env ブロック) で LOCALIZELY_PROJECT_ID を設定してください。引数が省略された場合、各ツールはこの値にフォールバックします。別のプロジェクトを対象にしたい場合は、単発の呼び出しで明示的に project_id を渡すこともできます。

セキュリティ

• .env ファイルをコミットしたり、API トークンをハードコードしたりしないでください。.gitignore はすでに .env を除外しています。

• API トークンは起動時に環境変数から読み取られます。サーバーはトークンがないと起動を拒否します。

• Localizely API キーは他の資格情報と同様に扱ってください。必要な範囲に限定し、漏えいした場合はローテーションし、issue、PR、ログで共有しないでください。

セキュリティの問題を発見した場合は、公開 issue ではなく非公開のレポートを開いてください。

ライセンス

MIT — LICENSE を参照してください。