Audius 的 Atris MCP
MCP（模型上下文协议）服务器通过 LLM（大型语言模型）提供对 Audius 音乐平台的访问。
特征
- 工具：访问曲目、用户、播放列表、专辑并在 Audius 上执行搜索
- 音频流：将音频内容直接从 Audius 流式传输到 AI 应用程序
- 内容创作：上传曲目、创建播放列表、管理您的 Audius 内容
- 社交功能：关注用户、收藏曲目、评论内容
- 货币化：访问优质内容、购买曲目、向艺术家发送小费
- 分析：跟踪播放次数、趋势数据和听众见解
- 资源：以结构化资源的形式访问曲目、用户、播放列表和专辑数据
- 提示：利用引导式体验进行音乐发现、管理和分析
自然语言能力
使用 Atris MCP，您可以用自然语言咨询关于 Audius 内容的法学硕士 (LLM) 问题。示例包括：
音乐探索
- “帮我找一些 BPM 高的电子乐曲”
- “本周嘻哈音乐的流行歌曲有哪些？”
- “推荐与[艺术家姓名]相似的艺术家”
- “帮我发现爵士乐流派的地下艺术家”
- “寻找适合冥想播放列表的放松心情曲目”
艺术家信息
- “跟我讲讲这位艺术家[名字]”
- “[艺术家] 最受欢迎的粉丝是谁？”
- “[艺术家] 最近发布了哪些曲目？”
- “向我展示[艺术家]最受欢迎曲目的分析数据”
- “哪些艺术家与[艺术家姓名]相似？”
播放列表管理
- “创建一个快节奏电子音乐播放列表”
- “将最流行的嘻哈音乐添加到我的健身播放列表中”
- “从我的播放列表 [名称] 中删除曲目 [标题]”
- “重新排列我的播放列表，让歌曲之间更加流畅”
- “帮我为派对策划一个播放列表”
轨迹分析
- “分析[曲目]的听众人口统计数据”
- “谁是[赛道]的顶级粉丝？”
- “与同类曲目相比，[曲目] 的表现如何？”
- “过去一个月内 [曲目] 的收听趋势如何？”
- “显示 [track] 的参与度指标”
内容货币化
- “为我的新赛道设置 NFT 门控”
- “我应该为我的优质内容收取多少费用？”
- “显示我的小费历史记录和统计数据”
- “分析我在整个平台上的收入来源”
- “帮助我了解[内容]的购买选项”
社交与社区互动
- “寻找经常与我的音乐互动的粉丝”
- “显示我最新曲目的评论”
- “帮我写一条与[艺术家]合作的消息”
- “我应该关注谁来扩大我在[类型]领域的人脉？”
- “分析我的社交参与度并提出改进建议”
- “找到给我打赏过的最支持我的粉丝”
- “追踪我的通知历史记录并优先处理重要通知”
工作流程自动化和创意协助
- “用营销时间表来规划我的下一首歌曲的发布”
- “根据我的收听习惯自动每周更新播放列表”
- “安排内容公告以实现最佳参与度”
- “为我的新环境音轨生成描述性标签”
- “将我的流派分类与类似艺术家进行比较”
- “根据我现有的目录表现建议定价策略”
- “帮我为我的个人资料制作一份引人入胜的艺术家简历”
先决条件
- Node.js 16 或更高版本
- Audius API 密钥（可选，但建议用于生产用途）
安装
通过 Smithery 安装
要通过Smithery自动安装 Atris for Claude Desktop：
npx -y @smithery/cli install @glassBead-tc/audius-mcp-atris --client claude
NPM 安装（推荐）
直接从 npm 安装：
npm install audius-mcp-atris
或者用纱线：
yarn add audius-mcp-atris
手动安装
- 克隆此存储库：
git clone https://github.com/glassBead/audius-mcp-atris.git
cd audius-mcp-atris
- 安装依赖项：
- 构建 TypeScript 代码：
Docker 安装
您还可以使用 Docker 构建并运行 MCP 服务器：
- 构建 Docker 镜像：
docker build -t audius-mcp-atris .
- 运行容器：
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 发现节点，而不是尝试使用本地节点。
- 对于 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 Configuration
AUDIUS_API_KEY=your_api_key_here
AUDIUS_API_SECRET=your_api_secret_here
AUDIUS_ENVIRONMENT=production # or staging, development
# MCP Server Configuration
SERVER_NAME=audius-mcp
SERVER_VERSION=1.0.0
用法
运行服务器
启动服务器：
这将自动启动主 MCP 服务器和音频流服务器。音频流服务器默认运行在 7070 端口（可通过 STREAM_SERVER_PORT 环境变量配置）。
如果您只需要启动流媒体服务器进行测试或开发：
node start-stream-server.js
连接到克劳德
要将此服务器与 Claude 一起使用：
- 安装Claude for Desktop或Claude CLI
NPX 安装（推荐）
使用此 MCP 服务器的最简单方法是使用 npx，它无需全局安装即可运行该包：
对于 Claude CLI：
claude mcp add audius npx audius-mcp-atris
对于 Claude 桌面：
编辑您的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"
}
}
}
本地安装方法
如果您更喜欢本地安装：
# Install the package globally
npm install -g audius-mcp-atris
# Then configure Claude CLI
claude mcp add audius audius-mcp-atris
# Or for Claude Desktop, use this in your config:
{
"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 # Entry point
│ ├── server.ts # MCP server setup
│ ├── config.ts # Configuration handling
│ ├── sdk-client.ts # Audius SDK client wrapper
│ ├── tools/ # MCP tool implementations
│ │ ├── tracks.ts # Track-related tools
│ │ ├── users.ts # User-related tools
│ │ ├── playlists.ts # Playlist-related tools
│ │ ├── search.ts # Search-related tools
│ │ ├── social.ts # Social interaction tools
│ │ ├── comments.ts # Comment management tools
│ │ ├── track-management.ts # Track upload and management
│ │ ├── playlist-management.ts # Playlist creation and management
│ │ ├── messaging.ts # Direct messaging tools
│ │ ├── analytics.ts # Analytics and metrics tools
│ │ ├── blockchain.ts # Cryptocurrency and blockchain tools
│ │ ├── monetization.ts # Premium content and payment tools
│ │ └── notifications.ts # Platform notification tools
│ ├── resources/ # MCP resource implementations
│ │ ├── tracks.ts # Track-related resources
│ │ ├── users.ts # User-related resources
│ │ └── playlists.ts # Playlist-related resources
│ └── prompts/ # MCP prompt implementations
│ ├── music-search.ts # Music discovery prompts
│ ├── track-info.ts # Track analysis prompts
│ ├── artist-profile.ts # Artist profile prompts
│ ├── music-creation.ts # Music creation prompts
│ ├── playlist-creation.ts # Playlist creation prompts
│ ├── messaging.ts # Messaging prompts
│ ├── analytics.ts # Analytics prompts
│ ├── blockchain.ts # Blockchain prompts
│ ├── monetization.ts # Monetization prompts
│ └── notifications.ts # Notification prompts
示例工作流程
音乐探索
// Search for electronic tracks
search-tracks --query "electronic" --limit 5
// Stream an audio track
stream-track --trackId "123456"
// Get trending tracks in a genre
get-trending-tracks --genre "House" --limit 10
// Find artists similar to a specific one
similar-artists --userId "123456"
内容创作
// Upload a new track
upload-track --userId "123" --title "Summer Vibes" --genre "Electronic" --audioFileUrl "https://example.com/track.mp3"
// Create a playlist
create-playlist --userId "123" --playlistName "Chillout Mix" --description "Perfect for relaxing"
// Add tracks to a playlist
add-tracks-to-playlist --userId "123" --playlistId "456" --trackIds ["789", "101", "102"]
社交功能
// Follow a user
follow-user --userId "123" --followeeId "456"
// Favorite a track
favorite-track --userId "123" --trackId "789"
// Add a comment
add-track-comment --trackId "789" --userId "123" --comment "Great track!"
货币化
// Check track access gates
track-access-gates --trackId "789"
// View purchase options
purchase-options --contentId "789" --contentType "track"
// Purchase a track
purchase-track --contentId "789" --walletAddress "0x123..." --purchaseOption "option1" --paymentToken "USDC" --amount "4.99" --signerPrivateKey "privateKey"
测试
对于本地开发测试：
- 安装MCP 检查器：
npm install -g @modelcontextprotocol/inspector
- 使用您的服务器运行检查器：
npx @modelcontextprotocol/inspector node ./build/index.js
执照
麻省理工学院