Каталог MCP
cfpramod/open-museum-mcp

cfpramod/open-museum-mcp

Сервер для единого поиска по пяти музейным коллекциям (Мет, Кливленд, Чикаго, Wikimedia Commons, Europeana) с верификацией прав на открытый доступ. Возвращает нормализованные метаданные, готовые ци...

README

7 инструментов

Версии

Установить сервер

open-museum-mcp

One search across open-access museum collections worldwide, with strict per-museum rights verification and ready-to-use citations.

The Met, Rijksmuseum, the Smithsonian, Cleveland Museum of Art, the Art Institute of Chicago, SMK (National Gallery of Denmark), the Walters, Wellcome Collection, Wikimedia Commons, and Europeana — searched together, returned in one normalized shape, with the rights gate enforced per museum so you never receive a record whose open-access status is missing or ambiguous. The list keeps growing.

See it in action first → pramod.ch/open-museum-mcp — three worked examples (cross-tradition pairing, date-windowed scan, counterpoint discovery), real records, real citations, no install required.

Who this is for

Art-history students and researchers who need cited references and rights-cleared images for papers, slides, and theses — across institutions, in one query.
Writers, educators, and journalists who want reuse-safe artwork to pair with essays, lessons, or articles, with pre-formatted attributions.
MCP / agent builders who want a small set of high-value tools (search_artworks, get_artwork, cite) with consistent schemas across sources, instead of installing one MCP per museum.

Инструменты были проиндексированы: 11.09.2026

cite

Сформировать ссылку на произведение искусства. Стили: "full" (художник, название, дата, музей, лицензия, URL), "caption" (форма подписи к изображению), "short" (встроенная ссылка).

Параметры

idstringобязательный
Normalized artwork ID.
styleenum

clearance_record

Выдаёт портативный, отказоустойчивый Clearance Manifest (проверка прав + происхождение + цитирование) для идентификатора произведения, упакованный в побайтово точный конверт целостности Tier-0: манифест передаётся как точная UTF-8 JSON строка в payload, с SHA-256 по этим точным байтам в integrity.hash. Потребители хешируют строку payload дословно, затем парсят её через JSON.parse для чтения. Непроверенная работа - отклонённая шлюзом прав, неизвестным музеем или неверным id - возвращает окончательный манифест DENY, а не ошибку: отказ - это корректный ответ. Соответствует спецификации Clearance Manifest в репозитории по пути spec/clearance/v0.1 (openclearance.org/v0.1).

Параметры

idstringобязательный
Normalized artwork ID, format museumcode:id (e.g. met:436535).

discover_random

Выбирает одно случайное произведение из локального кэша, подходящее под заданные ограничения. Пригодится, чтобы вырваться из однотипного поиска (например, показать случайную работу периода Эдо, чтобы не нарушать правило «нельзя подряд два европейских произведения до 1900 года»). Если кэш холодный и указаны ограничения region или period, инструмент сам наполняет кэш: делает маленький поиск через search_artworks на основе этих ограничений, а потом выбирает случайный образец — то есть работает с первого раза, без ручного разогрева кэша. Если ограничений нет, возвращает подсказку сначала запустить search_artworks.

Параметры

museumstring
Optional museum code to restrict to (e.g. met, rijksmuseum, smk, wellcome, walters).
not_artiststring[]
Artist names to exclude (exact match against the canonical artist name field).
periodstring
Normalized period tag (e.g. "tang dynasty", "edo", "safavid"). Exact match.
regionstring
Normalized region tag (e.g. "china", "japan", "netherlands"). Exact match.

facets

Возвращает доступные значения фасетов и их количество для запроса: категории медиума, вековые временные интервалы, ведущие художники и цветовые семейства. Количество вычисляется в ОГРАНИЧЕННОМ окне кандидатов — до ~150 записей с подтверждёнными правами на музей (НЕ по всему корпусу), поэтому отражается только начало результирующего набора, а не исчерпывающие итоги. Возвращаются только те значения, которые действительно присутствуют в этом окне (пустых корзин нет). Используйте полученные значения medium/colorFamily с search_artworks({ ..., medium, color_family }) для фильтрации.

Параметры

has_imageboolean
Restrict to records with an image URL.
museumstring
Optional museum code to restrict to.
querystringобязательный
Free-text query.
year_maxinteger
Optional inclusive upper bound on creation year (negative = BCE).
year_mininteger
Optional inclusive lower bound on creation year (negative = BCE).

get_artwork

Получить одно произведение искусства по его нормализованному ID (например, met:436533).

Параметры

idstringобязательный
Normalized artwork ID, format museumcode:numericid

list_traditions

Перечисляет регионы и периоды, присутствующие в неистекших кэшированных записях, с количеством записей по каждому музею. Помогает увидеть, какие традиции хорошо представлены перед поиском, а где коллекций мало. Возвращает { regions, periods }, где каждая запись содержит { tag, label, coverage: { museumCode: count } }. При пустом кэше возвращает подсказку сначала запустить search_artworks — list_traditions это мета-инструмент, работающий с уже собранными данными, а не триггер поиска.

Параметры

Без параметров.

search_artworks

Ищет по зарегистрированным открытым музейным коллекциям. Возвращает записи произведений, прошедшие проверку прав с учётом особенностей источника (неоднозначные записи по умолчанию исключаются). Поддерживает необязательный фильтр по диапазону дат: для исследовательских запросов вроде «голландская жанровая живопись 1640–1680».

Параметры

colorstring
Optional hex colour (#rrggbb). Re-ranks results by perceptual (CIEDE2000) nearness to this colour, nearest first. Colour is precomputed Node-side from the thumbnail; records without colour (not yet enriched) are excluded from a colour-ranked search.
color_familyenum
Optional coarse colour-family filter (red, orange, yellow, green, blue, purple, pink, brown, neutral, black, white). Post-fetch over the bounded window, so a rare family may return fewer than limit. Use the facets tool to see which families are present.
has_imageboolean
Restrict to records with an image URL. Defaults to true. Note: some museums (e.g. The Met) only expose images-only search server-side.
limitinteger
mediumenum
Optional medium-category filter. One of the controlled values (painting, drawing, print, photograph, sculpture, textile, ceramic, metalwork, furniture, manuscript, other). Like the year filter, it is applied after rights verification over a bounded candidate window — so a medium that is rare for the query may return fewer than limit results. Use the facets tool to see which values are present for a query.
museumstring
Optional museum code. Always available: met, cleveland, aic, rijksmuseum, walters, smk, wellcome, wikimedia (Commons). Key-gated: europeana (EUROPEANA_API_KEY), smithsonian (SMITHSONIAN_API_KEY). Omit to search every registered source.
querystringобязательный
Free-text query.
year_maxinteger
Optional inclusive upper bound on artwork creation year. Negative for BCE. Records with no parseable date are excluded when any year bound is set.
year_mininteger
Optional inclusive lower bound on artwork creation year. Negative for BCE (e.g. -500 = 500 BCE). Records with no parseable date are excluded when any year bound is set.

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "open-museum-mcp"
  ]
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Что он умеет?

open-museum-mcp is an MCP server that searches open-access museum collections across the world in one query, including the Met, Rijksmuseum, Smithsonian, Cleveland Museum of Art, Art Institute of Chicago, the National Gallery of Denmark, the Walters, Wellcome Collection, Wikimedia Commons, and Europeana. It returns records only if they pass per-museum rights verification, with strict deny on ambiguity, so you never get a record whose open-access status is missing or unclear. The server normalizes metadata across sources, including a date parser for dynasties like Tang or Edo, and outputs citations in three styles (full, caption, short) from the same record. It provides seven tools: search_artworks queries all collections at once; get_artwork fetches a single item by ID; cite generates a citation for any given record; list_traditions shows which regions and periods are present in the cached results with counts; facets returns available filter values (medium, century, artist, color) with counts; discover_random picks a random artwork from the local cache matching your constraints; and clearance_record emits a fail-closed Clearance Manifest for an artwork ID, including rights-clearance and provenance. This server is meant for art-history students, writers, educators, and MCP builders who want one interface across many institutions, instead of installing a separate MCP for each museum. It installs via one-click bundles for Claude Desktop and VS Code, or via npm, and works with a free API key where required.