@pipeworx/genius

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

Pipeworx の一部です — AI エージェントを 1476+ のライブデータソースに接続する MCP ゲートウェイです。

Tools

• search(query, limit?) — キーワード検索。曲のメタデータのヒットを返します。

• get_song(id) — 曲のメタデータ（タイトル、アーティスト、アルバム、リリース、ページビュー、概要）

• get_artist(id) — アーティストのメタデータ（名前、フォロワー、別名、概要）

• artist_songs(artist_id, limit?) — アーティストの曲を人気順に返します。

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

Related MCP server: mcp-lyrics-ovh

認証

• プラットフォームキー: _apiKey を省略すると、ゲートウェイによって注入されます。

• BYO: 無料の Client Access Token を https://genius.com/api-clients で登録した後、_apiKey=<token> を渡します。

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

データソース

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

クイックスタート

お使いの MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します:

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

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

tools/list（https://gateway.pipeworx.io/genius/mcp 内）は、上の表のツールに加えて、 Pipeworx 共通のメタツール — ask_pipeworx、 discover_tools、search_within、remember/recall など、 ゲートウェイ全体のセットを返します。したがって、表示されるツール数はこの表よりも多くなります。 現在、単一パックのエンドポイントでは、パック独自のツールに加えて約 30 の共通ツールが一覧表示されます。 接続の initialize 応答は正確なスコープを明示しており、 その時点での権威ある答えとなります。

これは意図的なものであり、偶然の多重化ではありません。メタツールにより、 スコープ付き接続は、このパックがカバーしない質問に回答できます — カタログ全体にルーティングする ask_pipeworx 経由で — MCP サーバーを追加することなく。現在、メタツールなしでパックエンドポイントをマウントする方法はありません。 追加のスキーマがルーティングの価値よりも多くのコンテキストを消費する場合は、 複数のパックエンドポイントに接続するのではなく、フルゲートウェイに一度接続してください。

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

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

どちらの URL も同じゲートウェイと同じ 1476+ のデータソースに到達します。 唯一の違いは、どのパックのツールが直接一覧表示されるかだけです。ask_pipeworx はどちらからでもすべてのツールに到達できます。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問することができます — これは上記のパックエンドポイントでもフルゲートウェイでも機能します:

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

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

詳細

• ドキュメントとガイド

• pipeworx.io

ライセンス

MIT