whitney-museum-mcp-server

MCP-сервер для публичного API Музея Уитни. Ищите коллекцию, художников, выставки, события и аудиогиды из Claude Desktop или любого MCP-клиента.

Не аффилирован с Музеем американского искусства Уитни. Это сторонняя обёртка над их публичным API, описанным на https://whitney.org/about/website/api.

API-ключ не нужен, так как API Уитни открыт и не требует аутентификации.

Установка

npx whitney-museum-mcp-server

Или из исходников:

git clone https://github.com/mildlydiverting/whitney-museum-mcp-server.git
cd whitney-museum-mcp-server
npm install
npm run build

Node 20 или новее.

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "whitney": {
      "command": "npx",
      "args": ["-y", "whitney-museum-mcp-server"]
    }
  }
}

Из исходников укажите путь к сборке:

{
  "mcpServers": {
    "whitney": {
      "command": "node",
      "args": ["/absolute/path/to/whitney-museum-mcp-server/dist/index.js"]
    }
  }
}

Закройте и снова откройте Claude Desktop. В конфиге ~ не раскрывается, поэтому используйте полный путь.

Инструменты

Что ожидать

Поиск возвращает краткие записи. Записи Уитни содержат длинные HTML-описания и биографии, поэтому поиск даёт базовую информацию, а whitney_get_* — всё остальное. Проза обрезается до 2 000 символов, полные ответы — до 25 000.

Пагинация — 30 записей на страницу. Это размер страницы API. page выбирает страницу, limit дополнительно сокращает её — значение по умолчанию 10 предотвращает переполнение контекста при широком поиске.

Синтаксис поиска — Ransack. Предикаты вкладываются в q (_eq, _cont, _cont_all_split, _gteq и другие), сортировка — в q[s]. Типизированные инструменты сопоставляют дружественные аргументы с ними. whitney_query предоставляет их в сыром виде для всего, что не охватывают типизированные инструменты.

Поля художников и произведений сопоставлены явно. Выставки, события, гиды и страницы проходят через универсальный суммаризатор: HTML удаляется, временные метки сокращаются до дат, относительные URL становятся абсолютными, внутренние внешние ключи отбрасываются. Музей заявляет, что набор полей может меняться, поэтому ничего не захардкожено без необходимости. Выполните поиск с limit: 1, чтобы увидеть реальные имена полей, затем используйте filters для конкретных запросов.

Известные особенности

Это особенности API, а не обёртки.

• sort: "random" не всегда даёт случайный порядок. Запрос трёх случайных произведений вернул три последовательных инвентарных номера одного художника. Если нужна настоящая случайность, запросите случайный номер страницы.

• display_date у произведений — свободный текст — «1915–1931, printed 1976–1977» — поэтому диапазоны дат там не работают. У выставок и событий есть настоящие временные метки, и starts_on_or_after / starts_on_or_before фильтруют по ним.

• У живых художников death_year: "0". Не выполняйте с ним арифметических операций.

• Ransack игнорирует нераспознанные предикаты, а не выдаёт ошибку, поэтому опечатка в поле молча возвращает всё. Проверяйте количество результатов.

Массовые данные

Для работы в больших объёмах не листайте API постранично. Уитни публикует CSV-файлы художников и произведений на https://github.com/whitneymuseum/open-access, выпущенные под лицензией CC0.

Интересные идеи

Попросите вашего дружелюбного робота установить связи между записями Уитни и других музеев с помощью MCP-серверов Getty ULAN и Wikidata.

(Я использую всё это, чтобы добавлять ссылки и более подробную информацию в свои учебные и исследовательские заметки.)

Лицензии

Код выпущен под лицензией MIT — см. LICENSE.

Основные данные принадлежат Музею Уитни. Материалы, доступные через API, могут быть защищены авторским правом и другими ограничениями. Уитни разрешает некоммерческое образовательное и личное использование, а также добросовестное использование при условии сохранения уведомлений об авторских правах и указания автора и источника. Прочитайте их условия на https://whitney.org/about/website/api, прежде чем создавать что-либо публичное на их основе.

Обратите внимание: наборы данных CSV, указанные выше, имеют лицензию CC0, что более разрешительно, чем условия API. Те же данные, другая дверь.

Благодарности

Цифровой команде Уитни за публикацию API и за его надлежащую документацию. Вы — самые замечательные.