Audius MCP Atris

🚀 Audius的Atris MCP

Atris MCP是一个MCP（模型上下文协议）服务器，它借助大语言模型（LLMs）为用户提供访问Audius音乐平台的途径。

✨ 主要特性

• 工具丰富：可访问Audius上的曲目、用户、播放列表和专辑，并能进行搜索。
• 音频流服务：直接将Audius的音频内容流式传输到AI应用程序。
• 内容创作：上传曲目、创建播放列表，管理你在Audius上的内容。
• 社交功能：关注用户、收藏曲目、对内容进行评论。
• 盈利模式：访问付费内容、购买曲目、向艺术家打赏。
• 数据分析：跟踪播放次数、热门数据和听众洞察。
• 资源获取：以结构化资源的形式访问曲目、用户、播放列表和专辑数据。
• 引导式体验：通过引导式体验进行音乐发现、策划和分析。

📚 详细文档

自然语言交互能力

借助Atris MCP，你可以用自然语言向大语言模型询问有关Audius内容的问题。例如：

音乐发现

• “帮我找到高BPM的电子音乐曲目”
• “本周嘻哈音乐流派中有哪些热门曲目？”
• “推荐与[艺术家姓名]风格相似的艺术家”
• “帮我发现爵士音乐流派中的地下艺术家”
• “为冥想播放列表寻找舒缓氛围的曲目”

艺术家信息

• “告诉我关于艺术家[姓名]的信息”
• “[艺术家]最受欢迎的粉丝有哪些？”
• “[艺术家]最近发布了哪些曲目？”
• “展示[艺术家]最热门曲目的分析数据”
• “哪些艺术家与[艺术家姓名]风格相似？”

播放列表管理

• “创建一个欢快电子音乐曲目的播放列表”
• “将热门嘻哈曲目添加到我的健身播放列表中”
• “从我的播放列表[名称]中移除曲目[标题]”
• “重新排列我的播放列表，使歌曲之间的过渡更流畅”
• “帮我为派对策划一个播放列表”

曲目分析

• “分析[曲目]的听众 demographics”
• “[曲目]的顶级粉丝有哪些？”
• “[曲目]与同流派的其他曲目相比表现如何？”
• “过去一个月[曲目]的收听趋势如何？”
• “展示[曲目]的参与度指标”

内容盈利

• “为我的新曲目设置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.example在根目录下创建一个.env文件：

# Audius API配置
AUDIUS_API_KEY=your_api_key_here
AUDIUS_API_SECRET=your_api_secret_here
AUDIUS_ENVIRONMENT=production # 或 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桌面版或Claude CLI

NPX安装（推荐）

使用npx是使用此MCP服务器的最简单方法，它可以在不全局安装包的情况下运行：

对于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"
      }
    }
  }
}

对于其他支持模型上下文协议的大语言模型应用程序：

在它们各自的配置文件中使用以下配置：

{
  "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获取专辑详细信息

引导式体验

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

• 音乐发现：根据偏好找到推荐曲目
• 曲目分析：分析曲目特征并获得洞察
• 艺术家简介：生成全面的艺术家概述
• 音乐创作：协助曲目创作和发布
• 播放列表策划：帮助创建和推广播放列表
• 消息互动：引导与其他用户的互动
• 数据分析：生成音乐表现的报告和洞察
• 区块链操作：协助加密货币和代币操作
• 盈利模式设置：指导付费内容设置和购买
• 通知管理：管理和组织平台通知

示例工作流程

音乐发现

// 搜索电子音乐曲目
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许可证。