Atris MCP for Audius

一个 MCP (模型上下文协议) 服务器，它通过 LLM (大型语言模型) 提供对 Audius 音乐平台的访问。

功能

• 工具: 访问 Audius 上的曲目、用户、播放列表、专辑，并执行搜索
• 音频流: 将音频内容直接从 Audius 流式传输到 AI 应用程序
• 内容创作: 上传曲目、创建播放列表、管理您的 Audius 内容
• 社交功能: 关注用户、收藏曲目、评论内容
• 货币化: 访问高级内容、购买曲目、向艺术家发送小费
• 分析: 跟踪播放次数、趋势数据和听众洞察
• 资源: 以结构化资源的形式访问曲目、用户、播放列表和专辑数据
• 提示: 使用引导式体验进行音乐发现、管理和分析

自然语言能力

使用 Atris MCP，您可以用自然语言向您的 LLM 提问有关 Audius 内容的问题。 示例包括：

音乐发现

• "为我找到 BPM 较高的电子音乐曲目"
• "本周嘻哈流派的流行曲目有哪些？"
• "推荐与 [艺术家姓名] 相似的艺术家"
• "帮助我发现爵士流派的地下艺术家"
• "找到适合冥想播放列表的具有放松心情的曲目"

艺术家信息

• "告诉我关于艺术家 [姓名] 的信息"
• "[艺术家] 最受欢迎的粉丝是谁？"
• "[艺术家] 最近发布了哪些曲目？"
• "向我展示 [艺术家] 最受欢迎曲目的分析"
• "哪些艺术家与 [艺术家姓名] 相似？"

播放列表管理

• "创建一个欢快的电子音乐曲目播放列表"
• "将最流行的嘻哈曲目添加到我的锻炼播放列表"
• "从我的播放列表 [名称] 中删除曲目 [标题]"
• "重新排序我的播放列表，以在歌曲之间创建更好的流程"
• "帮助我策划一个派对的播放列表"

曲目分析

• "分析 [曲目] 的听众人口统计信息"
• "[曲目] 的顶级粉丝是谁？"
• "与同类型中的其他曲目相比，[曲目] 的表现如何？"
• "过去一个月 [曲目] 的收听趋势是什么？"
• "向我展示 [曲目] 的参与度指标"

内容货币化

• "为我的新曲目设置 NFT 门控"
• "我的高级内容应该收取多少费用？"
• "向我展示我的小费历史记录和统计信息"
• "分析我在平台上的收入来源"
• "帮助我了解 [内容] 的购买选项"

社交和社区互动

• "找到经常与我的音乐互动的粉丝"
• "向我展示我最新曲目的评论"
• "帮助我撰写一条与 [艺术家] 合作的消息"
• "我应该关注谁来扩大我在 [流派] 场景中的网络？"
• "分析我的社交参与度并提出改进建议"
• "找到向我提供小费的最具支持性的粉丝"
• "跟踪我的通知历史记录并优先处理重要的通知"

工作流程自动化和创意协助

• "制定我的下一个曲目发布计划，并制定营销时间表"
• "根据我的收听习惯自动执行每周播放列表更新"
• "安排内容公告以获得最佳参与度"
• "为我的新环境曲目生成描述性标签"
• "将我的流派分类与相似的艺术家进行比较"
• "根据我现有目录的表现，提出定价策略"
• "帮助我为我的个人资料制作引人入胜的艺术家简介"

先决条件

• Node.js 16 或更高版本
• Audius API 密钥（可选，但建议用于生产环境）

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Atris：

npx -y @smithery/cli install @glassBead-tc/audius-mcp-atris --client claude

NPM 安装（推荐）

直接从 npm 安装：

npm install audius-mcp-atris

或者使用 yarn：

yarn add audius-mcp-atris

手动安装

1. 克隆此存储库：

git clone https://github.com/glassBead/audius-mcp-atris.git
cd audius-mcp-atris

2. 安装依赖项：

npm install

3. 构建 TypeScript 代码：

npm run build

Docker 安装

您还可以使用 Docker 构建和运行 MCP 服务器：

1. 构建 Docker 镜像：

docker build -t audius-mcp-atris .

2. 运行容器：

docker run -it --rm \
  -e AUDIUS_API_KEY=your_api_key_here \
  -e AUDIUS_API_SECRET=your_api_secret_here \
  -e AUDIUS_ENVIRONMENT=production \
  audius-mcp-atris

注意：将 AUDIUS_ENVIRONMENT 设置为 "production" 可确保 SDK 连接到公共 Audius 发现节点，而不是尝试使用本地节点。

3. 对于 Claude Desktop，配置您的 claude_mcp_config.json 以使用 Docker：

{
  "mcpServers": {
    "audius": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "audius-mcp-atris"
      ],
      "env": {
        "AUDIUS_API_KEY": "your_api_key_here",
        "AUDIUS_API_SECRET": "your_api_secret_here",
        "AUDIUS_ENVIRONMENT": "production"
      }
    }
  }
}

配置

在根目录中创建一个 .env 文件，基于提供的 .env.example：

# Audius API 配置
AUDIUS_API_KEY=your_api_key_here
AUDIUS_API_SECRET=your_api_secret_here
AUDIUS_ENVIRONMENT=production # or staging, development

# MCP 服务器配置
SERVER_NAME=audius-mcp
SERVER_VERSION=1.0.0

用法

运行服务器

启动服务器：

npm start

这将自动启动主 MCP 服务器和音频流服务器。 音频流服务器默认在端口 7070 上运行（可通过 STREAM_SERVER_PORT 环境变量配置）。

如果您只需要启动流媒体服务器进行测试或开发：

node start-stream-server.js

连接到 Claude

要将此服务器与 Claude 一起使用：

1. 安装 Claude for Desktop 或 Claude CLI

NPX 安装（推荐）

使用此 MCP 服务器的最简单方法是使用 npx，它可以运行该软件包而无需全局安装：

对于 Claude CLI：

claude mcp add audius npx audius-mcp-atris

对于 Claude Desktop：

编辑您的 claude_mcp_config.json 文件（位置因平台而异）：

• macOS: ~/Library/Application Support/Claude/claude_mcp_config.json
• Windows: %APPDATA%\Claude\claude_mcp_config.json
• Linux: ~/.config/Claude/claude_mcp_config.json

添加此配置：

{
  "mcpServers": {
    "audius": {
      "command": "npx",
      "args": [
        "audius-mcp-atris"
      ],
      "env": {
        "AUDIUS_API_KEY": "your_api_key_here",
        "AUDIUS_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

对于其他 LLM 应用程序：

对于支持模型上下文协议的应用程序，请在其各自的配置文件中使用此配置：

{
  "audius": {
    "command": "npx",
    "args": [
      "audius-mcp-atris"
    ],
    "env": {
      "AUDIUS_API_KEY": "your_api_key_here",
      "AUDIUS_API_SECRET": "your_api_secret_here"
    }
  }
}

本地安装方法

如果您喜欢本地安装：

# 全局安装软件包
npm install -g audius-mcp-atris

# 然后配置 Claude CLI
claude mcp add audius audius-mcp-atris

# 或者对于 Claude Desktop，请在您的配置中使用此配置：
{
  "mcpServers": {
    "audius": {
      "command": "audius-mcp-atris",
      "env": {
        "AUDIUS_API_KEY": "your_api_key_here",
        "AUDIUS_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

可用工具

该服务器提供以下功能：

发现工具

• 搜索: 使用各种过滤器查找曲目、用户、播放列表
• 高级搜索: 使用流派、心情、BPM 和其他过滤器进行搜索
• 趋势发现: 获取趋势或地下曲目
• 相似艺术家: 查找与您喜欢的艺术家相似的艺术家

曲目工具

• 流式传输曲目: 直接从 Audius 曲目流式传输音频
• 获取曲目信息: 按 ID 获取详细的曲目信息
• 搜索曲目: 使用各种过滤器查找曲目
• 热门曲目: 发现 Audius 上的热门内容
• 曲目评论: 查看和添加曲目评论
• 曲目分析: 监听计数、趋势数据、受众洞察

用户工具

• 用户个人资料: 获取详细的用户信息
• 用户曲目: 列出用户上传的曲目
• 关注用户: 关注其他用户
• 用户分析: 跟踪播放指标、支持者等

内容创作

• 上传曲目: 将新曲目添加到 Audius
• 更新曲目: 修改现有曲目元数据
• 创建播放列表: 构建曲目集合
• 播放列表管理: 添加、删除和重新排序曲目

社交互动

• 关注艺术家: 与最喜欢的创作者联系
• 收藏曲目: 保存并表达对音乐的欣赏
• 评论: 添加曲目评论
• 转发: 查看谁转发了内容
• 消息: 发送和接收直接消息

货币化

• 高级内容: 访问和购买门控内容
• NFT 门控内容: 检查和验证基于 NFT 的访问
• 购买曲目: 使用各种付款方式购买高级内容
• 发送小费: 直接支持艺术家
• 跟踪交易: 查看小费历史记录和统计信息

区块链和钱包

• 钱包管理: 管理以太坊和 Solana 钱包
• 代币余额: 检查加密货币余额
• 交易: 查看历史记录并执行转账
• 奖励: 访问 Audius 平台奖励和挑战

资源

使用以下 URI 模板访问 Audius 数据：

• audius://track/{id}: 按 ID 获取曲目详细信息
• audius://user/{id}: 按 ID 获取用户个人资料
• audius://playlist/{id}: 按 ID 获取播放列表详细信息
• audius://album/{id}: 按 ID 获取专辑详细信息

提示

该服务器为常见的音乐相关任务提供引导式体验：

• 音乐发现: 根据偏好查找推荐
• 曲目分析: 分析曲目特征并获得洞察
• 艺术家个人资料: 生成全面的艺术家概述
• 音乐创作: 协助曲目创作和发布
• 播放列表管理: 帮助创建和推广播放列表
• 消息: 指导与其他用户的互动
• 分析: 生成有关音乐表现的报告和洞察
• 区块链: 协助加密货币和代币操作
• 货币化: 指导高级内容设置和购买
• 通知: 管理和组织平台通知

开发

项目结构

├── src/
│   ├── index.ts          # 入口点
│   ├── server.ts         # MCP 服务器设置
│   ├── config.ts         # 配置处理
│   ├── sdk-client.ts     # Audius SDK 客户端包装器
│   ├── tools/            # MCP 工具实现
│   │   ├── tracks.ts               # 曲目相关工具
│   │   ├── users.ts                # 用户相关工具
│   │   ├── playlists.ts            # 播放列表相关工具
│   │   ├── search.ts               # 搜索相关工具
│   │   ├── social.ts               # 社交互动工具
│   │   ├── comments.ts             # 评论管理工具
│   │   ├── track-management.ts     # 曲目上传和管理
│   │   ├── playlist-management.ts  # 播放列表创建和管理
│   │   ├── messaging.ts            # 直接消息工具
│   │   ├── analytics.ts            # 分析和指标工具
│   │   ├── blockchain.ts           # 加密货币和区块链工具
│   │   ├── monetization.ts         # 高级内容和支付工具
│   │   └── notifications.ts        # 平台通知工具
│   ├── resources/        # MCP 资源实现
│   │   ├── tracks.ts     # 曲目相关资源
│   │   ├── users.ts      # 用户相关资源
│   │   └── playlists.ts  # 播放列表相关资源
│   └── prompts/          # MCP 提示实现
│       ├── music-search.ts      # 音乐发现提示
│       ├── track-info.ts        # 曲目分析提示
│       ├── artist-profile.ts    # 艺术家个人资料提示
│       ├── music-creation.ts    # 音乐创作提示
│       ├── playlist-creation.ts # 播放列表创建提示
│       ├── messaging.ts         # 消息提示
│       ├── analytics.ts         # 分析提示
│       ├── blockchain.ts        # 区块链提示
│       ├── monetization.ts      # 货币化提示
│       └── notifications.ts     # 通知提示

示例工作流程

音乐发现

// 搜索电子音乐曲目
search-tracks --query "electronic" --limit 5

// 流式传输音频曲目
stream-track --trackId "123456"

// 获取流派中的热门曲目
get-trending-tracks --genre "House" --limit 10

// 查找与特定艺术家相似的艺术家
similar-artists --userId "123456"

内容创作

// 上传新曲目
upload-track --userId "123" --title "Summer Vibes" --genre "Electronic" --audioFileUrl "https://example.com/track.mp3"

// 创建播放列表
create-playlist --userId "123" --playlistName "Chillout Mix" --description "Perfect for relaxing"

// 将曲目添加到播放列表
add-tracks-to-playlist --userId "123" --playlistId "456" --trackIds ["789", "101", "102"]

社交功能

// 关注用户
follow-user --userId "123" --followeeId "456"

// 收藏曲目
favorite-track --userId "123" --trackId "789"

// 添加评论
add-track-comment --trackId "789" --userId "123" --comment "Great track!"

货币化

// 检查曲目访问门
track-access-gates --trackId "789"

// 查看购买选项
purchase-options --contentId "789" --contentType "track"

// 购买曲目
purchase-track --contentId "789" --walletAddress "0x123..." --purchaseOption "option1" --paymentToken "USDC" --amount "4.99" --signerPrivateKey "privateKey"

测试

对于本地开发测试：

1. 安装 MCP Inspector：

npm install -g @modelcontextprotocol/inspector

2. 使用您的服务器运行检查器：

npx @modelcontextprotocol/inspector node ./build/index.js

许可证

MIT