Listenbrainz

mcp-listenbrainz

ListenBrainz MCP。

Pipeworx の一部です。AI エージェントを 1882 以上のライブデータソースにつなぐ MCP ゲートウェイです。これは独立した非公式のインテグレーションであり、上流プロバイダーとは提携しておらず、同社の承認や公開を受けたものでもありません。

ツール

ツール	説明
top_artists	ListenBrainz サイト全体のトップアーティスト（オープンな音楽リスニングデータ、MetaBrainz／MusicBrainz と連携）。期間内に全ユーザーが最も多く聴いたアーティストです。認証キーは不要です。
user_listens	名前が明示された特定の ListenBrainz ユーザーの最近のリスニング履歴（トラックのスクロブル）を新しい順に取得します。質問でユーザー名が指定された場合に限り使用してください。推測したユーザー名や例示用のユーザー名は使わないでください。オープンな音楽リスニングデータで、MusicBrainz と連携しています。公開プロフィールでは認証キーは不要です。
now_playing	ListenBrainz ユーザーが現在聴いている曲（再生中のトラックがある場合）。オープンな音楽リスニングデータです。公開プロフィールでは認証キーは不要です。
user_top_artists	名前が明示された特定の ListenBrainz ユーザーが、期間内に最も多く聴いたアーティストを取得します。質問で ListenBrainz のユーザー名が指定された場合に限り使用してください。「人気の音楽をおすすめして」や「2026年のトップソング」のような一般的な質問には絶対に使用しないでください（その場合は last-fm の chart_top_artists／tag_top_artists を使用してください）。また、推測したユーザー名や例示用のユーザー名も使わないでください。見知らぬ人の個人的なリスニング履歴を回答として提示することになります。オープンな音楽リスニングデータで、MusicBrainz と連携しています。公開プロフィールでは認証キーは不要です。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "listenbrainz": {
      "url": "https://gateway.pipeworx.io/listenbrainz/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/listenbrainz/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx の共有メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールとともに、およそ 30 個の共有ツールが一覧表示されます。接続の initialize レスポンスには正確なスコープが示され、その日の状況を確認するための信頼できる情報源となります。

これは意図的な仕様であり、偶発的な多重化ではありません。メタツールを使うと、このパックが対応していない質問にも、カタログ全体からルーティングする ask_pipeworx を介して回答できます。そのため、2つ目の MCP サーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールを直接一覧表示できます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1882 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/top_artists \
  -H 'Content-Type: application/json' \
  -d '{"range":"week","count":10}'

最初の呼び出しにはアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/top_artists を使用します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへのラウンドトリップも不要です。

{
  "mcpServers": {
    "listenbrainz": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-listenbrainz"]
    }
  }
}

または、直接実行して起動することを確認します。

npx -y @pipeworx/mcp-listenbrainz

標準入力／標準出力経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントでもフルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Listenbrainz data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT