@pipeworx/genius

Genius MCP — метаданные песен / исполнителей / альбомов, поиск и описания аннотаций Genius. Тексты песен не возвращаются Genius API (лицензирование) — этот пакет возвращает названия, ID, статистику, URL-адреса страниц Genius и описания «about».

Это часть Pipeworx — MCP-шлюза, соединяющего AI-агентов с 1476+ живыми источниками данных.

Инструменты

• search(query, limit?) — поиск по ключевым словам; возвращает совпадения по метаданным песен

• get_song(id) — метаданные песни (название, исполнитель, альбом, релиз, просмотры, about)

• get_artist(id) — метаданные исполнителя (имя, подписчики, альтернативные имена, about)

• artist_songs(artist_id, limit?) — песни исполнителя, отсортированные по популярности

_apiKey необязателен для каждого инструмента — опустите его, чтобы использовать ключ платформы.

Related MCP server: mcp-lyrics-ovh

Аутентификация

• Ключ платформы: автоматически добавляется шлюзом, когда _apiKey опущен.

• Свой ключ: передайте _apiKey=<token> после регистрации бесплатного Client Access Token на https://genius.com/api-clients.

Отправляется как 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