labelgrid-mcp

Name: labelgrid-mcp
Author: labelgrid

本地服务

labelgrid.com商业与营销44 周前更新

代码仓库访问官网

关于 labelgrid-mcp

labelgrid-mcp 是 LabelGrid 公共 API 的官方 MCP 服务，提供 30 个用于管理音乐目录和发行流程的工具。它属于一个同时提供命令行工具和共享 API 客户端的工作区。

主要功能

01管理音乐目录和发行内容
02处理文件与分发
03访问分析数据和版税信息
04管理 Webhook
05使用 30 个整合 API 工具

适用场景

01通过 MCP 客户端管理音乐目录
02处理发行与分发任务
03查看分析数据和版税信息

MCP 相关

@labelgrid/mcp 包通过 LabelGrid 公共 API 向 MCP 客户端提供 30 个工具。项目还提供用于同一 API 功能范围的命令行工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "labelgrid-labelgrid": {
      "command": "npx",
      "args": [
        "-y",
        "@labelgrid/mcp"
      ],
      "env": {
        "LABELGRID_API_TOKEN": "<LABELGRID_API_TOKEN>",
        "LABELGRID_API_URL": "<LABELGRID_API_URL>",
        "LABELGRID_ENABLE_WRITES": "<LABELGRID_ENABLE_WRITES>",
        "LABELGRID_ENABLE_FULL_WRITES": "<LABELGRID_ENABLE_FULL_WRITES>",
        "LABELGRID_FULL_WRITES_ACK": "<LABELGRID_FULL_WRITES_ACK>",
        "LABELGRID_TOOLSETS": "<LABELGRID_TOOLSETS>",
        "LABELGRID_READ_ONLY": "<LABELGRID_READ_ONLY>"
      }
    }
  }
}

启动命令npx -y @labelgrid/mcp

需要配置的环境变量

LABELGRID_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+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@labelgrid/mcp0.4.0stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

LabelGrid MCP — 工作区

面向 LabelGrid 公共 API 的官方 LabelGrid 工具集，以 npm 工作区的形式组织。

在找 MCP 服务文档？ 请参阅 packages/mcp/README.md——其中包含 Claude Desktop / Cursor / 任何 MCP 客户端的安装说明、完整工具参考、安全门控和配置。

软件包

软件包	内容
`@labelgrid/mcp`	MCP 服务——通过 LabelGrid 公共 API 提供 30 个整合工具。已发布到 npm；也提供 `labelgrid.mcpb` 一键安装包，可用于 Claude Desktop。
`@labelgrid/cli`	`labelgrid` 命令行工具——为终端和脚本提供相同的 API 功能：目录、发行、文件、分析、版税、webhook 和分发，并支持为管道提供 `--json` 输出。
`@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'

Agent 技能

skills/labelgrid-release/SKILL.md 是一项 Agent 技能，涵盖完整的发行生命周期——起草发行及其曲目、上传音频和封面、验证、审核、分发并跟踪交付——为每个步骤提供准确的 MCP 工具和 CLI 命令，并说明适合使用哪种方式。将该文件提供给 Agent，或放入助手的技能目录，即可教会它 LabelGrid 端到端发行流程。

布局与构建安排

根目录下的 package.json 是私有工作区清单；其中的脚本会分发到各个软件包（npm run build 会先构建 @labelgrid/core，再构建 @labelgrid/mcp 和 @labelgrid/cli；npm test 会运行每个软件包的测试套件）。贡献者在仓库根目录下工作：packages/core 是共享客户端，packages/mcp 是 MCP 服务，packages/cli 是命令行工具——这两个产品都是基于 core 构建的轻量适配器。
每个软件包都有自己的 tsconfig.json，并扩展共享的 tsconfig.base.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。