Audius Mcp Atris

娱乐 TypeScript

🚀 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

手动安装

克隆此仓库：

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

安装依赖：

npm install

构建TypeScript代码：

npm run build

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发现节点，而不是尝试使用本地节点。 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一起使用：

安装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"

测试

对于本地开发测试：

安装MCP Inspector：

npm install -g @modelcontextprotocol/inspector

使用你的服务器运行检查器：

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

📄 许可证

本项目采用MIT许可证。

0 条评论
分类：娱乐

Audius Mcp Atris

🚀 Audius的Atris MCP

✨ 主要特性

📚 详细文档

自然语言交互能力

音乐发现

艺术家信息

播放列表管理

曲目分析

内容盈利

社交与社区互动

工作流程自动化与创意辅助

📦 安装指南

前置条件

通过Smithery安装

NPM安装（推荐）

手动安装

Docker安装

🔧 技术细节

配置

💻 使用示例

运行服务器

连接到Claude

NPX安装（推荐）

对于Claude CLI：

对于Claude Desktop：

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

本地安装方法

可用工具

发现工具

曲目工具

用户工具

内容创作

社交互动

盈利模式

区块链与钱包

资源访问

引导式体验

示例工作流程

音乐发现

内容创作

社交功能

盈利模式

测试

📄 许可证

0 个评论

相似服务问题

热议话题 »