适用于 Audius 的 Atris MCP(v2.0.0)
**注意:**版本 2.0.0+ 专门使用 STDIO 传输实现所有功能。
MCP(模型上下文协议)服务器通过 LLM(大型语言模型)提供对 Audius 音乐平台的访问。
特征
工具:访问曲目、用户、播放列表、专辑并在 Audius 上执行搜索
内容创作:上传曲目、创建播放列表、管理您的 Audius 内容
社交功能:关注用户、收藏曲目、评论内容
货币化:访问优质内容、购买曲目、向艺术家发送小费
分析:跟踪播放次数、趋势数据和听众见解
资源:以结构化资源的形式访问曲目、用户、播放列表和专辑数据
提示:利用引导式体验进行音乐发现、管理和分析
Related MCP server: Spotify MCP Server
自然语言能力
使用 Atris MCP,您可以用自然语言咨询关于 Audius 内容的法学硕士 (LLM) 问题。示例包括:
音乐探索
“帮我找一些 BPM 高的电子乐曲”
“本周嘻哈音乐的流行歌曲有哪些?”
“推荐与[艺术家姓名]相似的艺术家”
“帮我发现爵士乐流派的地下艺术家”
“寻找适合冥想播放列表的放松心情曲目”
艺术家信息
“跟我讲讲这位艺术家[名字]”
“[艺术家] 最受欢迎的粉丝是谁?”
“[艺术家] 最近发布了哪些曲目?”
“向我展示[艺术家]最受欢迎曲目的分析数据”
“哪些艺术家与[艺术家姓名]相似?”
播放列表管理
轨迹分析
“分析[曲目]的听众人口统计数据”
“谁是[赛道]的顶级粉丝?”
“与同类曲目相比,[曲目] 的表现如何?”
“过去一个月内 [曲目] 的收听趋势如何?”
“显示 [track] 的参与度指标”
内容货币化
“为我的新赛道设置 NFT 门控”
“我应该为我的优质内容收取多少费用?”
“显示我的小费历史记录和统计数据”
“分析我在整个平台上的收入来源”
“帮助我了解[内容]的购买选项”
社交与社区互动
“寻找经常与我的音乐互动的粉丝”
“显示我最新曲目的评论”
“帮我写一条与[艺术家]合作的消息”
“我应该关注谁来扩大我在[类型]领域的人脉?”
“分析我的社交参与度并提出改进建议”
“找到给我打赏过的最支持我的粉丝”
“跟踪我的通知历史记录并优先处理重要通知”
工作流程自动化和创意协助
先决条件
安装
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 代码:
配置
根据提供的.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
用法
运行服务器
启动服务器:
对于自动重建的开发:
连接到克劳德
要将此服务器与 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"
}
}
}
}
可用工具
该服务器提供以下功能:
发现工具
轨道工具
获取轨迹信息:通过 ID 获取轨迹的详细信息
搜索曲目:使用各种过滤器查找曲目
热门曲目:发现 Audius 上的热门曲目
曲目评论:查看和添加曲目评论
跟踪分析:收听次数、趋势数据、受众洞察
用户工具
用户资料:获取详细的用户信息
用户曲目:列出用户上传的曲目
关注用户:关注其他用户
用户分析:跟踪游戏指标、支持者等
内容创作
上传曲目:向 Audius 添加新曲目
更新轨道:修改现有轨道元数据
创建播放列表:创建曲目集合
播放列表管理:添加、删除和重新排序曲目
社交互动
关注艺术家:与喜爱的创作者联系
最喜欢的曲目:保存并表达对音乐的欣赏
评论:为曲目添加评论
转发:查看谁转发了内容
消息传递:发送和接收直接消息
货币化
区块链和钱包
钱包管理:管理以太坊和 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
// 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
执照
麻省理工学院