labelgrid-mcp について
labelgrid-mcp は LabelGrid 公開 API の公式 MCP サーバーで、音楽カタログやリリースを扱う 30 個のツールを提供します。コマンドラインツールと共有 API クライアントも含むワークスペースの一部です。
主な機能
- 01音楽カタログとリリースの管理
- 02ファイルと配信の処理
- 03分析データとロイヤリティの利用
- 04Webhook の管理
- 0530 個の統合 API ツール
活用シーン
- 01MCP クライアントから音楽カタログを管理
- 02リリースと配信のタスク処理
- 03分析データとロイヤリティの確認
MCP 対応
@labelgrid/mcp パッケージは LabelGrid 公開 API を通じて、30 個のツールを MCP クライアントに公開します。同じ API 機能を扱うコマンドラインツールも含まれます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @labelgrid/mcpLABELGRID_API_TOKENシークレットYour LabelGrid API token. Create one in your dashboard under Profile → API Tokens. Without it the server starts in setup mode and walks you through creating one.LABELGRID_API_URLOverride the API base URL. Defaults to the production API.LABELGRID_ENABLE_WRITESEnable safe writes (create/update drafts, labels, artists, and similar). Enabled by default; set to false for read-only.LABELGRID_ENABLE_FULL_WRITESEnable full writes (distribution, takedowns, immutable uploads). Disabled by default; also requires LABELGRID_FULL_WRITES_ACK.LABELGRID_FULL_WRITES_ACKMust equal the exact acknowledgment sentence (see the README safety section) to arm full writes.LABELGRID_TOOLSETSComma-separated subset of toolsets to expose (account, reference, catalog, releases, insights, finance, webhooks, distribution; pre-0.3.0 names are accepted as aliases). Defaults to all except webhooks, which must be named explicitly to enable.LABELGRID_READ_ONLYForce reads only; overrides both write flags. Defaults to false.ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
29掲載時のツール一覧 · 2 週間前に更新
このツールにパラメーターはありません。
詳細
LabelGrid MCP — ワークスペース
LabelGrid 公開 API 用の公式 LabelGrid ツール群を、npm ワークスペースとしてまとめています。
MCP サーバーのドキュメントをお探しですか？ packages/mcp/README.md にあります。Claude Desktop、Cursor、その他の MCP クライアントへのインストール方法、ツールの完全なリファレンス、安全性の制御、設定方法を記載しています。
パッケージ
| パッケージ | 内容 |
|---|---|
@labelgrid/mcp | MCP サーバーです。LabelGrid 公開 API を利用する、統合された 30 個のツールを提供します。npm で公開されており、Claude Desktop 用のワンクリックバンドル labelgrid.mcpb としても配布されています。 |
@labelgrid/cli | labelgrid コマンドラインツールです。カタログ、リリース、ファイル、分析、ロイヤリティ、Webhook、配信に対応し、パイプライン向けの --json 出力も備えています。ターミナルやスクリプトから同じ API を利用できます。 |
@labelgrid/core | 共有 API クライアントです。構造化エラーに対応した HTTP トランスポート、署名付き URL によるアップロード、コンテンツタイプの許可リスト、カタログエンティティレジストリ、機密情報を伏せるログ機能を提供します。公開 API を基盤とするすべての LabelGrid ツールで使用されます。 |
コマンドラインツール
認証設定、各コマンドグループ、スクリプト作成、安全性モデルの完全なドキュメントは
packages/cli/README.md にあります。クイックスタート：
npm install -g @labelgrid/cli # Node 20+; installs the `labelgrid` command
export LABELGRID_API_TOKEN=... # or run `labelgrid auth login`
labelgrid auth whoami # verify the token
labelgrid catalog search --type release --json | jq '.data[].id'
エージェントスキル
skills/labelgrid-release/SKILL.md は、リリースの下書きとトラックの作成、オーディオとアートワークのアップロード、検証、レビュー、配信、納品状況の追跡まで、リリースの全ライフサイクルを扱うエージェントスキルです。各手順に適した手段のガイダンスと、対応する正確な MCP ツールおよび CLI コマンドを記載しています。エージェントにこのファイルを参照させるか、アシスタントのスキルディレクトリに配置すると、LabelGrid のリリースフローを最初から最後まで実行できるようになります。
構成とビルドの仕組み
- ルートの
package.jsonはプライベートなワークスペースマニフェストです。そのスクリプトは各パッケージに処理を振り分けます（npm run buildはまず@labelgrid/coreをビルドし、続いて@labelgrid/mcpと@labelgrid/cliをビルドします。npm testは各パッケージのテストを実行します）。開発者はリポジトリのルートから作業します。packages/coreは共有クライアント、packages/mcpは MCP サーバー、packages/cliはコマンドラインツールで、2 つの製品はいずれも core 上の薄いアダプターです。 - 各パッケージは、共有の
tsconfig.base.jsonを継承する独自のtsconfig.jsonを持ちます（TypeScript のプロジェクト参照は使用していません。ルートでビルド順序を明示することで、順序を正しくシンプルに保ちます）。@labelgrid/mcpはワークスペースリンクを通じて@labelgrid/coreをインポートし、ビルド済みの宣言ファイルを使ってコンパイルします。 - ユニットテストは、各パッケージの
vitest.config.tsを使ってパッケージごとに実行します。MCP パッケージは@labelgrid/coreを隣接パッケージの TypeScript ソースにエイリアスするため、テストの実行前に core をビルドする必要はありません。 - リポジトリ全体のチェックは
scripts/にあり、ルートから実行します。npm run lint、npm run leak-guard、npm run check-coverage、npm run gen-docs、npm run measure-tokensが該当します。
開発
npm ci # install the whole workspace
npm run build # build core, then mcp and cli
npm test # unit suites for every package
npm run lint # biome over the repo
ビルド後の MCP サーバーバイナリ：node packages/mcp/dist/index.js（または npm start）。
ビルド後の CLI バイナリ：node packages/cli/dist/index.js。
ライセンス
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。