Genius

@pipeworx/genius

Genius MCP — 楽曲／アーティスト／アルバムのメタデータ、検索、Genius の注釈の説明を提供します。Genius API はライセンス上の理由から歌詞テキストを返しません。このパックが返すのは、タイトル、ID、統計情報、Genius ページの URL、「概要」の説明です。

Pipeworx の一部です — AI エージェントを 1879 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携機能であり、上流プロバイダーとの提携、承認、公開はありません。

ツール

• search(query, limit?) — キーワード検索。楽曲のメタデータを返します
• get_song(id) — 楽曲のメタデータ（タイトル、アーティスト、アルバム、リリース、ページビュー、概要）
• get_artist(id) — アーティストのメタデータ（名前、フォロワー数、別名、概要）
• artist_songs(artist_id, limit?) — 人気順のアーティスト楽曲

すべてのツールで_apiKeyは任意です。省略するとプラットフォームキーが使用されます。

認証

• プラットフォームキー： _apiKeyが省略されると、ゲートウェイによって挿入されます。
• BYO： https://genius.com/api-clients で無料の Client Access Token を登録した後、_apiKey=<token>を渡します。

すべてのリクエストでAuthorization: Bearer <token>として送信されます。

データソース

https://api.genius.com — Bearer アクセストークン。

クイックスタート

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

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

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

https://gateway.pipeworx.io/genius/mcp のtools/listは、上の表のツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recallなど、ゲートウェイ全体で使える一連のツール）を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、このパック専用のツールと併せて、およそ 30 個の共有ツールが表示されます。接続のinitializeレスポンスには、正確な対象範囲が記載されており、その日の時点での確定情報です。

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

このパックのツールだけでなく、各パックのすべてのツールを直接一覧表示するには、Pipeworx ゲートウェイ全体に接続してください。

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/genius_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"humble kendrick lamar","limit":10}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/genius_searchを使用します。ツールを見つけるには、{"query":"..."}を指定してPOST https://gateway.pipeworx.io/v1/tools/search_packsを呼び出します。

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

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

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

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-genius

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

ask_pipeworx を使用する

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

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

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

詳細

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

ライセンス

MIT