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許可證。