translatize について
translatize は Translatize 統合 API を扱う TypeScript ツール群です。SDK、翻訳同期とブランチ管理のコマンドラインツール、AI エージェント向け MCP サーバーで構成されています。
主な機能
- 01統合 API 用 TypeScript SDK
- 02ラベルの読み取り、検索、編集、ブランチ管理
- 03翻訳の取得、送信、状態確認用 CLI
- 04AI エージェント向け MCP サーバー
- 05GitHub と GitLab 用 CI テンプレート
活用シーン
- 01翻訳ラベルの確認と更新
- 02CI ワークフローでの翻訳同期
- 03AI エージェントへの翻訳 API 操作の提供
MCP 対応
@translatize/mcp パッケージは MCP サーバーを提供し、標準入出力経由で AI エージェントに統合 API を公開します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @translatize/mcpTRANSLATIZE_API_TOKENシークレットTranslatize integration API token (an "mcni_..." string), bound to one project and branch. Create it under Project Settings -> Integrations at https://app.translatize.com.TRANSLATIZE_API_URLAPI base URL including the /v1 segment. Defaults to https://api.translatize.com/v1.TRANSLATIZE_APP_URLWeb-app base URL used to build review links. Defaults to https://app.translatize.com.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
18掲載時のツール一覧 · 1 週間前に更新
このツールにパラメーターはありません。
詳細
Translatize のインテグレーション
Translatize インテグレーション API(Authorization: Bearer mcni_... で認証するマシントークン API)用のクライアント側ツールです。これは npm ワークスペースのルートで、リポジトリ内のアプリとは意図的に分離されています。workspaces を持つ package.json はここにしかなく、リポジトリのルートには package.json がありません。
パッケージ
| パッケージ | ディレクトリ | 状態 | 内容 |
|---|---|---|---|
@translatize/core | core/ | 利用可能 | インテグレーション API 用の依存関係ゼロの TypeScript SDK(クライアントと flatten/unflatten ヘルパー)。ほかのすべての基盤となる共通機能です。 |
@translatize/cli | cli/ | 利用可能 | @translatize/core を基盤に構築されたコマンドラインツール(translatize init/pull/push/status)。Git に似たブランチ機能で、CI から翻訳を同期します。 |
@translatize/mcp | mcp/ | 利用可能 | @translatize/core を基盤に構築され、stdio 経由で AI エージェント(Claude Code、Cursor など)に API を公開する Model Context Protocol サーバーです。 |
CI テンプレート
すぐに使える 2 つの CI インテグレーションがパッケージを補完します。npm パッケージではなく、@translatize/cli(npx @translatize/cli ...)をシェルから呼び出すため、npm install ではなく、ワークフロー/パイプラインの設定として利用します。
| テンプレート | ホーム | 内容 |
|---|---|---|
| GitHub Action | github.com/Translatize/sync-action | GitHub ワークフロー向けに CLI の pull/push/status をラップする複合アクション(translatize/sync-action)です。 |
| GitLab CI | gitlab.com/translatize/gitlab | CI/CD カタログコンポーネント(templates/translatize.yml)と、コピーして貼り付けられる .gitlab-ci.yml ジョブです。 |
開発
cd integrations
npm install # installs every workspace and hoists dev deps
npm run build # builds each workspace that defines a build script
npm test # runs each workspace's test suite
Node.js >= 18.17(ネイティブの fetch、node:test)が必要です。
公開
@translatize/core、@translatize/cli、@translatize/mcp パッケージは、npm の @translatize スコープで公開されています。公開は手動で行います。ここで自動的に公開されることはありません。リリースするには、まずビルドしてから、各パッケージのディレクトリで npm publish --access public を実行します(または npm publish --workspaces を実行します)。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。