AI导哈

音乐分发协议服务器

Revelator MCP Server 是一个为AI助手提供音乐分发、目录管理、版税和区块链等服务的模型上下文协议服务器。

  • by Revelator-il
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Revelator-il/revelator-mcp

使用说明

Revelator MCP服务器

MCP（模型上下文协议）服务器，为AI助手提供对Revelator平台API的访问，用于音乐分发、目录管理、版税、区块链等。

安装

npm install @revelator/mcp-server

或全局安装：

npm install -g @revelator/mcp-server

认证

Revelator使用两种身份验证方法：

方法 标题格式 用例
合作伙伴API密钥 Authorization: <key> 管理端点，在合作伙伴入职期间提供
访问令牌 Authorization: Bearer <token> 用户身份验证请求，有效期为8小时

获取访问令牌

使用 auth_login 用于验证和接收访问令牌的工具（有效期为8小时）：

  • 提供 partnerApiKey 加上 username/password （提示登录）或 partnerUserId （自动登录）

对于新用户，请使用 auth_signup 首先创建一个帐户。使用 auth_forgot_password 启动密码重置。

Manual API call 
curl -X POST https://api.revelator.com/partner/account/login \
  -H "Content-Type: application/json" \
  -d '{
    "partnerApiKey": "your-partner-api-key",
    "username": "user@example.com",
    "password": "userpassword"
  }'

看 狂欢者API文件 获取完整的身份验证详细信息。

配置

将您的凭据设置为环境变量：

# Option 1: Partner API Key (for admin/partner endpoints)
export REVELATOR_PARTNER_API_KEY=your-partner-api-key

# Option 2: Access Token (for user-authenticated requests)
export REVELATOR_ACCESS_TOKEN=your-access-token

如果两者都设置，则访问令牌优先。

使用Claude Desktop

添加到您的Claude Desktop配置(~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "revelator": {
      "command": "npx",
      "args": ["@revelator/mcp-server"],
      "env": {
        "REVELATOR_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

或使用合作伙伴API密钥：

{
  "mcpServers": {
    "revelator": {
      "command": "npx",
      "args": ["@revelator/mcp-server"],
      "env": {
        "REVELATOR_PARTNER_API_KEY": "your-partner-api-key"
      }
    }
  }
}

可用工具（共61个）

身份验证工具（3）

工具 说明
auth_login 验证并获取访问令牌（有效期8小时）
auth_signup 创建新的Revelator帐户和用户
auth_forgot_password 启动密码重置流程

分析工具（5）

工具 说明
analytics_consumption_by_track 按轨迹获取流媒体消费数据
analytics_consumption_by_artist 按艺术家获取流媒体消费数据
analytics_consumption_by_release 通过发布获取流媒体消费数据
analytics_artificial_streams_by_track 获取人工/可疑的流媒体活动（欺诈检测）
analytics_artificial_streams_dashboard 获取人工流仪表板指标

区块链工具（11）

工具 说明
blockchain_list_royalty_tokens 列出版税代币
blockchain_get_royalty_token 获取版税代币详细信息
blockchain_get_token_holders 获取版税代币的当前持有者
blockchain_check_isrc_duplicate 检查轨道ISRC是否已标记
blockchain_get_token_count 获取版税代币总数
blockchain_search_payees 搜索区块链收款人
blockchain_get_payee 获取区块链收款人详细信息
blockchain_get_payee_wallet 获取收款人钱包详细信息
blockchain_get_balance 在网络上获取钱包余额
blockchain_get_transaction 通过哈希获取交易详细信息
blockchain_get_smart_wallet_transactions 获取智能钱包交易

目录工具（5）

工具 说明
catalog_search_tracks 按标题、艺术家或ISRC搜索曲目
catalog_get_track 获取详细的赛道信息
catalog_search_releases 搜索发布（专辑、单曲、EP）
catalog_get_release 获取详细的发布信息
catalog_list_labels 列出记录标签

核心工具（6）

工具 说明
core_get_whitelabel 获取白标品牌配置
core_get_user_permissions 获取用户的权限
core_list_artists 使用筛选功能列出艺术家
core_list_payees 通过筛选列出收款人
core_list_youtube_channels 列出YouTube MCN频道
core_submit_feedback 提交用户反馈

分发工具（8）

工具 说明
distro_get_acrcloud_results 从ACRCloud获取音频指纹分析
distro_get_asset_monetization 获取资产的货币化策略
distro_list_monetization_policies 列出可用的货币化政策选项
distro_get_release_pricing 获取发布的定价级别
distro_get_pricing_options 获取可用的定价级别选项
distro_get_release_monetization 获取跟踪级别的货币化策略
distro_get_territory_clearances 获得地区分销许可
distro_get_watchlist_matches 获取监视列表匹配项（潜在冲突）

通用API工具（15）

工具 说明
generic_get_current_user 获取当前用户配置文件
generic_get_sessions 获取活动用户会话
generic_get_permissions 获取用户权限和访问级别
generic_list_payees 列出所有收款人
generic_get_payee 获取收款人详细信息
generic_get_payee_insights 获取收款人分析和见解
generic_get_payee_balance 获取收款人余额信息
generic_list_contracts 列出所有合同
generic_get_contract 获取合同详细信息
generic_get_contract_summary 获取合同摘要数据
generic_list_transactions 列出付款交易记录
generic_get_transactions_grouped 获取分组交易分析
generic_get_playlist_analytics 获取播放列表性能分析
generic_get_playlist_movements 在播放列表中获取曲目定位更改

支付工具（3）

工具 说明
payments_list_external_accounts 列出外部支付账户
payments_get_bridge_account 获取Bridge支付集成账户
payments_get_bamboo_account 获取Bamboo支付集成账户

特许权使用费工具（5）

工具 说明
royalties_list_contracts 列出特许权使用费合同
royalties_get_contract 获取合同详细信息
royalties_list_statements 列出收款人对账单
royalties_list_runs 列出特许权使用费处理运行
royalties_list_sales_reports 列出销售报告

API域

域 基本URL 描述
分析 platform.revelator.com/Analytics 流媒体指标、欺诈检测
区块链 platform.revelator.com/Blockchain 特许权代币、钱包、链上
目录 platform.revelator.com/Catalog 曲目、版本、标签
核心 platform.revelator.com/Core 用户、权限、集成
Distro platform.revelator.com/supply-chain 货币化、定价、分销
通用 api.revelator.com 传统api、会计、合同
支付 platform.revelator.com/Payments 外部账户、支付集成
版税 platform.revelator.com/版税 合同、声明、运行

许可证

麻省理工学院

相关 MCP