Soundtrack MCP

音轨MCP服务器

使用AI为您的业务地点提供全面的音乐管理。此MCP服务器连接 原声带 Claude、ChatGPT和任何兼容MCP的AI助手——播放控制、音乐发现、日程创建、区域分配等。

建造于 bmasia --Soundtrack经销商。

它能做什么？

用自然语言与您的AI助手交谈：

• *“大厅里现在在玩什么？”*
• *“将餐厅区的音量调到5”*
• *“搜索冷爵士播放列表”* （包括预览链接）
• *“制定每周时间表：爵士乐早晨、休息室晚上”*
• *“将该时间表分配给大厅区域”*
• *“排队播放下一首特定曲目”*
• *“显示我的所有声音区域”*

______________________________________________________________________

bmasia客户快速入门

如果您的帐户由bmasia管理，您可以使用我们的托管服务器在几分钟内连接。无需安装，无需API密钥，无需托管。

询问您的bmasia代表，他们会给您发送 服务器网址 和你的 帐户ID.更换 YOUR_SERVER 和 YOUR_ACCOUNT_ID 在下面的例子中。

克劳德桌面版

编辑您的配置文件：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "soundtrack": {
      "type": "url",
      "url": "https://YOUR_SERVER/c/YOUR_ACCOUNT_ID/mcp"
    }
  }
}

重新启动克劳德桌面。您将在连接器中看到“配乐”。

Claude.ai（网络和移动）

1. 首选 claude.ai > 设置 > 连接器
2. 点击 添加自定义连接器
3. 输入URL： https://YOUR_SERVER/c/YOUR_ACCOUNT_ID/mcp
4. 点击 添加 --OAuth将自动完成
5. 开始新的聊天并尝试： *“现在在玩什么？”*

ChatGPT

1. 首选 chatgpt.com > 设置 > 应用程序
2. 启用 开发人员模式 （需要ChatGPT Plus）
3. 点击 添加连接器 并输入URL：

   https://YOUR_SERVER/c/YOUR_ACCOUNT_ID/mcp

1. OAuth将自动完成
2. 开始新的聊天并尝试： *“显示我的声音区域”*

多个账户

如果您管理多个帐户，请用逗号分隔：

https://YOUR_SERVER/c/ACCOUNT_ID_1,ACCOUNT_ID_2/mcp

帐户隔离

每个作用域的URL只能访问指定的帐户。酒店A看不到酒店B的数据——他们每个人都有自己的URL和自己的帐户ID。

______________________________________________________________________

自助主机（适用于非bmasia用户）

如果你是 不 作为bmasia客户，您需要自己的Soundtrack API证书和自己的服务器。托管的bmasia服务器使用bmasia的API密钥，该密钥仅适用于bmasia-managed帐户。

1.获取API证书

在申请API访问权限 soundtrack.io/our-api/apply。您将收到客户端ID和客户端密码。

创建base64编码的令牌：

echo -n "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" | base64

2.克隆并安装

git clone https://github.com/brightears/soundtrack-mcp.git
cd soundtrack-mcp
npm install

3.配置

cp .env.example .env

编辑 .env 并添加您的base64编码令牌：

SOUNDTRACK_API_TOKEN=your_base64_encoded_token_here

4.建造

npm run build

5.连接到克劳德桌面（本地）

编辑您的配置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "soundtrack": {
      "command": "node",
      "args": ["/full/path/to/soundtrack-mcp/dist/index.js"],
      "env": {
        "SOUNDTRACK_API_TOKEN": "your_base64_encoded_token_here"
      }
    }
  }
}

重新启动克劳德桌面。

6.部署为HTTP服务器（用于网络/移动访问）

要与Claude.ai、ChatGPT或任何远程MCP客户端一起使用，请部署HTTP服务器：

npm run start:http

从端口3000开始（或 PORT env变量）。该服务器包括Claude.ai和ChatGPT所需的内置OAuth 2.1支持。

部署到Render、Railway、Fly.io或任何Node.js主机。集 SOUNDTRACK_API_TOKEN 作为环境变量。

部署后，使用服务器的URL将其添加为Claude.ai或ChatGPT中的连接器（例如。 https://your-server.com/mcp).

7.（可选）特定账户的范围

有两种方法可以限制哪些帐户可见：

通过URL路径 （适用于多客户端设置）：

https://your-server.com/c/ACCOUNT_ID_1,ACCOUNT_ID_2/mcp

通过环境变量 （适用于单客户端设置）：

SOUNDTRACK_ACCOUNT_IDS=ACCOUNT_ID_1,ACCOUNT_ID_2

角色和权限

两个连接角色，由HTTP端点+ OPERATOR_TOKEN env 是：

• 客户 — /c//mcp。仅限于URL中的帐户ID。除 subscription_activate 和 account_register。不触发计费。
• 操作员 — /operator/mcp （或 /mcp 随着 X-Operator-Token 头球完全访问服务器的API令牌可以看到的所有帐户。所有可用的工具，包括影响成本的工具。

当 OPERATOR_TOKEN 未设置（自托管/单用户安装），每个端点默认为operator，门为no-op。

对于多租户部署（例如BMAsia托管客户端），设置 OPERATOR_TOKEN 在服务器上，分发 /c//mcp URL指向客户端，并将运算符URL+令牌保持在内部。

作用域别名

否则，拥有多个帐户的客户（例如，拥有250多家酒店的连锁酒店）需要每个帐户ID都有一个7KB以上的URL。通过定义短别名 SCOPE_ALIASES env-var（JSON映射），这样他们就可以得到一个干净的URL，比如 /c/tui/mcp:

# On the server (e.g. Render env vars)
SCOPE_ALIASES='{"tui":"id1,id2,id3,...","other-chain":"id4,id5"}'

然后，客户通过以下方式连接：

https://your-server/c/tui/mcp

别名解析为服务器端的完整帐户ID列表。如果路径段不是已知别名，则将其视为原始逗号分隔列表（向后兼容）。

获取 /scope-aliases 返回操作调试的名称+每个别名帐户计数（不公开ID）。

可用工具（41）

发现

回放控制

图书馆与音乐探索

进度管理

区域分配

内容管理

AI功能

管理员--帐户/位置/区域生命周期

管理员--订阅生命周期

管理员--验证

建筑

src/
  client.ts    GraphQL client + auth
  queries.ts   GraphQL queries & mutations
  tools.ts     MCP tool definitions (shared)
  auth.ts      OAuth 2.1 provider (auto-approving)
  index.ts     stdio entry point (Claude Desktop)
  http.ts      HTTP entry point (Claude.ai / ChatGPT / remote)
  api.ts       REST API router

内置：

• 模型上下文协议SDK v1.26
• 配乐GraphQL API
• TypeScript、Express、Zod

发展

npm run dev      # Watch mode (auto-recompile)
npm run build    # One-time compile
npm run inspect  # MCP Inspector (test tools interactively)

许可证

麻省理工学院