Audius 用 Atris MCP (v2.0.0)
**注:**バージョン 2.0.0 以降では、すべての機能に STDIO トランスポートのみを使用します。
LLM (大規模言語モデル) を介して Audius 音楽プラットフォームへのアクセスを提供する MCP (モデル コンテキスト プロトコル) サーバー。
特徴
ツール:Audiusでトラック、ユーザー、プレイリスト、アルバムにアクセスし、検索を実行します
コンテンツ作成: トラックのアップロード、プレイリストの作成、Audiusコンテンツの管理
ソーシャル機能: ユーザーをフォロー、お気に入りのトラック、コンテンツにコメント
収益化: プレミアムコンテンツへのアクセス、トラックの購入、アーティストへのチップの送信
分析: 再生回数、トレンドデータ、リスナーのインサイトを追跡
リソース: トラック、ユーザー、プレイリスト、アルバムデータに構造化されたリソースとしてアクセスします
プロンプト: ガイド付きのエクスペリエンスを使用して音楽を発見、キュレーション、分析します
Related MCP server: Spotify MCP Server
自然言語機能
Atris MCPを使用すると、Audiusコンテンツについて自然言語でLLMの質問を行うことができます。例えば、以下のような質問です。
音楽の発見
「BPMの高いエレクトロニックトラックを探して」
「今週のヒップホップジャンルのトレンドの曲は何ですか？」
「[アーティスト名]に似たアーティストをおすすめ」
「ジャズのジャンルのアンダーグラウンドアーティストを発見するのを手伝ってください」
「瞑想プレイリストに最適な、リラックスできる雰囲気のトラックを探す」
アーティスト情報
「アーティスト[名前]について教えてください」
「[アーティスト]の最も人気のあるフォロワーは誰ですか？」
「[アーティスト]は最近どんなトラックをリリースしましたか？」
「[アーティスト]の最も人気のあるトラックの分析を表示」
「[アーティスト名]に似ているアーティストは誰ですか？」
プレイリスト管理
「アップビートなエレクトロニックトラックのプレイリストを作成する」
「ワークアウトのプレイリストに、今一番人気のヒップホップトラックを追加」
「プレイリスト[名前]からトラック[タイトル]を削除」
「曲間の流れを良くするためにプレイリストを並べ替える」
「パーティー用のプレイリストの作成を手伝って」
トラック分析
「[トラック]のリスナー層を分析する」
「[トラック]のトップファンは誰ですか？」
「[トラック] は、同じジャンルの他のトラックと比べてどうですか？」
「過去 1 か月間の [トラック] の聴取傾向はどのようなものですか?」
「[トラック]のエンゲージメント指標を表示してください」
コンテンツの収益化
「新しいトラックのNFTゲーティングを設定する」
「プレミアムコンテンツにはいくら請求すればよいでしょうか？」
「チップの履歴と統計を表示してください」
「プラットフォーム全体の収益源を分析する」
「[コンテンツ]の購入オプションについて教えてください」
社会とコミュニティの交流
「私の音楽に頻繁に関わってくれるファンを見つける」
「最新のトラックのコメントを表示」
「[アーティスト]とコラボレーションするためのメッセージの作成を手伝ってください」
「[ジャンル]シーンでネットワークを拡大するには誰をフォローすればよいでしょうか？」
「私のソーシャルエンゲージメントを分析し、改善を提案してください」
「私にチップをくれた最も応援してくれるファンを見つけてください」
「通知履歴を追跡し、重要な通知を優先する」
ワークフロー自動化とクリエイティブ支援
「マーケティングタイムラインに沿って次のトラックリリースを計画する」
「自分の視聴習慣に基づいて毎週プレイリストを自動更新する」
「最適なエンゲージメントのためにコンテンツのアナウンスをスケジュールする」
「新しいアンビエントトラックの説明タグを生成する」
「私のジャンル分類を類似アーティストと比較する」
「既存のカタログのパフォーマンスに基づいて価格戦略を提案してください」
「私のプロフィールに魅力的なアーティストプロフィールを作成してください」
前提条件
Node.js 16以上
Audius API キー (オプションですが、本番環境での使用には推奨されます)
インストール
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依存関係をインストールします:
npm installTypeScript コードをビルドします。
npm run build構成
提供された.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使用法
サーバーの実行
サーバーを起動します。
npm start自動再構築による開発の場合:
npm run devクロードへの接続
このサーバーをClaudeで使用するには:
Claude for DesktopまたはClaude CLIをインストールする
NPX のインストール (推奨)
この MCP サーバーを使用する最も簡単な方法は、npx を使用することです。npx を使用すると、パッケージをグローバルにインストールせずに実行できます。
Claude CLIの場合:
claude mcp add audius npx audius-mcp-atrisClaude Desktopの場合:
claude_mcp_config.jsonファイルを編集します (場所はプラットフォームによって異なります)。
macOS :
~/Library/Application Support/Claude/claude_mcp_config.jsonWindows :
%APPDATA%\Claude\claude_mcp_config.jsonLinux :
~/.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、その他のフィルターで検索
トレンドの発見: トレンドやアンダーグラウンドのトラックを入手
類似アーティスト: 好きなアーティストに似たアーティストを検索
トラックツール
トラック情報を取得: IDによる詳細なトラック情報
トラックを検索: さまざまなフィルターを使ってトラックを検索
トレンドトラック：Audiusで人気の曲を見つけよう
トラックコメント: トラックのコメントを表示および追加します
トラック分析: 視聴回数、トレンドデータ、視聴者のインサイト
ユーザーツール
ユーザープロフィール: 詳細なユーザー情報を取得する
ユーザートラック: ユーザーがアップロードしたトラックを一覧表示します
ユーザーをフォロー: 他のユーザーをフォロー
ユーザー分析: プレイ指標、サポーターなどを追跡
コンテンツ作成
トラックのアップロード:Audiusに新しいトラックを追加する
トラックの更新: 既存のトラックのメタデータを変更する
プレイリストを作成: トラックのコレクションを構築する
プレイリスト管理: トラックの追加、削除、並べ替え
社会的交流
アーティストをフォロー: お気に入りのクリエイターとつながる
お気に入りのトラック: 音楽を保存して感謝の気持ちを表しましょう
コメント: トラックにコメントを追加する
再投稿: 誰がコンテンツを再投稿したかを確認します
メッセージング: ダイレクトメッセージを送受信する
収益化
プレミアムコンテンツ: ゲートコンテンツへのアクセスと購入
NFTゲートコンテンツ: NFTベースのアクセスをチェックして検証する
トラックを購入: さまざまな支払いオプションでプレミアムコンテンツを購入
チップを送る: アーティストを直接サポートする
取引を追跡: チップの履歴と統計を表示
ブロックチェーンとウォレット
ウォレット管理: Ethereumと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 Inspectorをインストールします。
npm install -g @modelcontextprotocol/inspectorサーバーでインスペクターを実行します。
npx @modelcontextprotocol/inspector node ./build/index.jsライセンス
マサチューセッツ工科大学