whitney-museum-mcp-server
whitney-mcp-ts
Whitney Museum의 공개 API를 위한 MCP 서버입니다. Claude Desktop 또는 모든 MCP 클라이언트에서 소장품, 아티스트, 전시, 이벤트, 오디오 가이드를 검색하세요.
TypeScript, stdio 전용, API의 Ransack 구문에 맞는 친숙한 매개변수, 출처 표기 포함, 모델 컨텍스트에서 관리하기 쉽도록 응답을 줄입니다.
Whitney의 API는 공개되어 있고 인증이 필요 없습니다. API 키가 필요 없습니다.
설치
npx whitney-mcp-ts또는 소스에서:
git clone https://github.com/mildlydiverting/whitney-mcp-ts.git
cd whitney-mcp-ts
npm install
npm run buildNode 20 이상.
Related MCP server: Wikipedia MCP Server
Claude Desktop
claude_desktop_config.json에 추가하세요:
{
"mcpServers": {
"whitney": {
"command": "npx",
"args": ["-y", "whitney-mcp-ts"]
}
}
}소스에서 실행하는 경우 빌드를 가리키도록 하세요:
{
"mcpServers": {
"whitney": {
"command": "node",
"args": ["/absolute/path/to/whitney-mcp-ts/dist/index.js"]
}
}
}Claude Desktop을 종료하고 다시 여세요. 구성 파일은 ~를 확장하지 않으므로 전체 경로를 사용하세요.
도구
도구 | 기능 |
| 제목, 아티스트, 분류, 매체, 날짜, 전시 상태로 27,000점 이상의 작품 검색 |
| 한 작품의 전체 레코드 — 크기, 크레딧 라인, 설명, 이미지 URL |
| 7,000명 이상의 아티스트 검색; 컬렉션, 비엔날레, 전시 여부로 필터링 |
| 전체 아티스트 레코드, 약력, Getty ULAN 및 Wikidata ID 포함 |
| 특정 아티스트의 작품 |
| 특정 아티스트가 참여한 전시 |
| 1931년 이후의 전시, 날짜 필터링 포함 |
| 전시 하나의 레코드 |
| 2008년 이후의 강연, 투어, 프로그램 |
| 2009년 이후 공개된 오디오 가이드 |
| 임의의 엔드포인트, 원시 Ransack 조건 사용 |
기대할 수 있는 것
검색은 간결한 레코드를 반환합니다.
Whitney 레코드에는 긴 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을 절대 URL로 변환, 내부 외래 키 제거. 박물관은 필드 집합이 변경될 수 있다고 하므로, 필요한 것 외에는 하드코딩하지 않습니다. limit: 1로 검색하여 실제 필드 이름을 확인한 다음 특정 항목은 filters를 사용하세요.
출처 표기
모든 응답은 박물관 이름과 이용 약관을 링크하는 출처 줄로 끝납니다. 상세 레코드에는 두 개의 출처 필드도 포함됩니다:
rights— Whitney 자체 설명 텍스트에서 추출한 저작권 고지citation— 미리 만들어진 마크다운 줄, 예:
Edward Hopper, Early Sunday Morning, 1930. Whitney Museum of American Art, © Heirs of Josephine N. Hopper/Licensed by Artists Rights Society (ARS), New York.
권리 보유자는 대개 아티스트가 아닙니다. 열 개 작품 표본 중 아홉 개는 달랐습니다 — 유산, 재단, 그리고 ARS와 VAGA 같은 권리 단체 등. 따라서 rights는 추측하지 말고 읽을 가치가 있습니다. Whitney의 약관이 유지하도록 요구하는 고지입니다.
저작권 고지가 없는 작품(대부분 오래된 자료)은 박물관 링크 뒤에 끝나는 출처가 제공됩니다.
대량 데이터
대규모 작업에는 API를 페이지별로 탐색하지 마세요. Whitney는 https://github.com/whitneymuseum/open-access에서 CC0로 공개된 아티스트 및 작품 CSV를 제공합니다.
알려진 API 특이사항
sort: "random"은 안정적으로 랜덤화하지 않습니다. 무작위 작품 세 개를 요청했는데 같은 아티스트의 연속된 세 개의 접근 번호가 반환되었습니다. 진정한 무작위가 필요하면 대신 무작위 페이지 번호를 요청하세요.작품의
display_date는 자유 텍스트입니다 — "1915–1931, printed 1976–1977" — 따라서 날짜 범위는 그 필드에서 작동하지 않습니다. 전시와 이벤트는 실제 타임스탬프가 있으며starts_on_or_after/starts_on_or_before가 그들을 필터링합니다.살아있는 아티스트는
death_year: "0"을 가집니다. 그 값으로 산술 연산을 하지 마세요.Ransack은 인식하지 못하는 조건을 오류 대신 무시하므로, 철자가 틀린 필드는 조용히 모든 것을 반환합니다. 결과 수를 확인하세요.
보안
Whitney의 API는 키가 필요 없으므로 자격 증명이 없고, 유출할 것도, 구성할 것도 없습니다.
모든 도구는 읽기 전용입니다. 서버는 whitney.org에 GET 요청만 하고 그 외에는 아무것도 하지 않습니다 — 파일시스템 접근, 셸, 쓰기 없음. 엔드포인트 이름은 고정 목록에서 오고, 레코드 ID는 URL 인코딩되며, 필터 매개변수는 URLSearchParams를 거칩니다.
알려진 제한 사항: HTML-to-markdown 변환은 중첩된 수량자를 가진 정규식을 사용하므로, 의도적으로 잘못된 입력이 들어오면 역추적이 심각해질 수 있습니다. 입력은 사용자가 아닌 Whitney 자체 CMS에서 오기 때문에, 이런 일이 발생한다면 NYC에서 뭔가 아주 잘못된 것이고 아마도 제 잘못은 아닐 것입니다.
문제를 발견하면 이슈를 열어 주세요.
개발
npm test # unit tests, offline
npm run test:canary # live checks against the Whitney API
npm run inspect # MCP Inspector against the built server카나리 스위트는 CI에서 매월 실행됩니다. 이는 Whitney가 필드 이름을 변경하는 것을 잡아내기 위한 것으로, 저장된 픽스처를 대상으로 실행되는 단위 테스트가 볼 수 없는 실패 모드입니다.
라이선스
코드: MIT 라이선스.
Whitney는 API와 함께 다음 주의사항을 제공합니다:
The data accessed through this API may be protected by copyright, and other restrictions, of the Whitney Museum of American Art and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
공개적으로 구축하기 전에 https://whitney.org/about/website/api에서 이용 약관을 읽으세요.
위에 링크된 CSV 데이터셋은 CC0이며, API 약관보다 허용적일 수 있습니다.
Whitney Museum of American Art와 제휴 관계가 아닙니다. 이는 해당 공개 API를 둘러싼 서드파티 래퍼이며, 문서는 https://whitney.org/about/website/api에서 확인할 수 있습니다.
감사의 말
Sam Parsons의 whitney-museum-mcp도 참조하세요 — 동일한 API를 사용하는 Python/FastMCP 서버로, Docker 및 HTTP 전송을 지원합니다.
API를 공개하고 제대로 문서화해 준 Whitney의 디지털 팀에게 감사드립니다. 그리고 자신들이 claude code를 사용한다고 명시한 좋은 블로그 글을 써 준 것에도 감사합니다. 그 덕분에 이 모든 것을 vibe coding한 것에 대한 죄책감이 덜 느껴지니까요.
Available Tools
11 toolswhitney_artist_artworksList an artist's artworksARead-onlyIdempotent
List the collection works by one artist.
Args:
id (string): artist ID
page (number, default 1), limit (number, 1-30, default 10)
response_format ('markdown' | 'json', default 'markdown')
Returns: { total, count, page, has_more, next_page?, results[] } with slim artwork records.
Use this rather than whitney_search_artworks with an artist name — it matches on the artist record rather than the credit line, so collaborative and attributed works are handled correctly.
Inputs: id (required), page, limit, response_format. Returns: note, page, count, total, +4 more
whitney_artist_exhibitionsList an artist's exhibitionsARead-onlyIdempotent
List Whitney exhibitions featuring one artist.
Args:
id (string): artist ID
page (number, default 1), limit (number, 1-30, default 10)
response_format ('markdown' | 'json', default 'markdown')
Returns: { total, count, page, has_more, next_page?, results[] }.
Exhibition fields are passed through generically (HTML stripped, long prose truncated), because the Museum documents these fields as subject to change. Coverage is fuller for recent decades than for the Museum's early history.
Inputs: id (required), page, limit, response_format. Returns: note, page, count, total, +4 more
whitney_get_artistGet a Whitney artistARead-onlyIdempotent
Fetch one artist's full record, including their biography where the Museum has published one.
Args:
id (string): TMS ID or 'T'-prefixed reference
response_format ('markdown' | 'json', default 'markdown')
Returns: { record: { id, name, sort_name, dates, birth_year, death_year, in_collection, in_biennial, in_artport, on_view, ulan_id, wikidata_id, biography, page_url } }
The biography is stripped of HTML and truncated. ulan_id (Getty ULAN) and wikidata_id are useful for cross-referencing other sources.
Inputs: id (required), response_format. Returns: record, source
whitney_get_artworkGet a Whitney artworkARead-onlyIdempotent
Fetch one artwork's full record by ID.
Args:
id (string): the artwork's TMS ID, as returned by whitney_search_artworks
response_format ('markdown' | 'json', default 'markdown')
Returns: { record: { id, title, artist, artist_ids[], date, medium, dimensions, classification, department, accession_number, credit_line, on_view, description, object_label, visual_description, alt_text, images[], page_url } }
Fields are omitted when empty. Alt text is human-written where available and AI-generated otherwise; alt_text_is_ai_generated flags which.
Errors: returns a 404 message if the ID does not exist.
Inputs: id (required), response_format. Returns: record, source
whitney_get_exhibitionGet a Whitney exhibitionARead-onlyIdempotent
Fetch one exhibition record by ID.
Args:
id (string): exhibition ID, as returned by whitney_search_exhibitions
response_format ('markdown' | 'json', default 'markdown')
Returns: { record: {...} } — fields as published by the API, HTML stripped.
Inputs: id (required), response_format. Returns: record, source
whitney_queryRaw Whitney API queryARead-onlyIdempotent
Escape hatch for queries the typed tools do not cover. Hits any endpoint with arbitrary Ransack predicates.
Args:
endpoint ('artists' | 'artworks' | 'exhibitions' | 'events' | 'guides' | 'pages')
id (string, optional): fetch a single record instead of a list
filters (object, optional): raw predicates, e.g. { "medium_cont_all_split": "graphite paper" }
sort (string, optional): e.g. 'popularity desc'
page (number, default 1), limit (number, 1-30, default 10)
response_format ('markdown' | 'json', default 'markdown')
Returns: a list result, or { record: {...} } when 'id' is supplied.
Prefer the typed tools where they fit — they return tidier records. Use this to discover field names, combine unusual predicates, or reach the 'pages' endpoint. Note that 'pages' mirrors the Museum's CMS structure and is rarely useful outside it.
Inputs: endpoint (required), id, page, sort, +3 more.
whitney_search_artistsSearch Whitney artistsARead-onlyIdempotent
Search the 7,000+ artists listed by the Whitney — those with work in the collection and those who have appeared in Museum exhibitions.
Returns slim records (id, name, dates, in_collection, in_biennial, on_view). Call whitney_get_artist for the biography and authority IDs.
Args:
name (string, optional): substring match on the display name
in_collection, in_biennial, on_view (boolean, optional)
sort ('default' | 'name_asc' | 'name_desc' | 'most_viewed' | 'random')
page (number, default 1), limit (number, 1-30, default 10)
response_format ('markdown' | 'json', default 'markdown')
Returns: { total, count, page, has_more, next_page?, results[], note? }
Example: "which O'Keeffes are in the collection?" -> search name="O'Keeffe", then whitney_artist_artworks with the returned id.
Inputs: name, page, sort, limit, +4 more. Returns: note, page, count, total, +4 more
whitney_search_artworksSearch Whitney artworksARead-onlyIdempotent
Search the Whitney Museum's online collection of 27,000+ works.
Returns slim records (id, title, artist, date, medium, classification, on view, first image URL). Call whitney_get_artwork for the full record including dimensions, credit line, description and all images.
Args:
title, artist, medium, date (string, optional): substring matches
classification (string, optional): exact match, e.g. "Drawings"
department ('collection' | 'artport' | 'special', optional)
on_view (boolean, optional)
sort ('default' | 'title_asc' | 'title_desc' | 'most_viewed' | 'random')
page (number, default 1), limit (number, 1-30, default 10)
response_format ('markdown' | 'json', default 'markdown')
Returns: { total, count, page, has_more, next_page?, results[], note? }
Examples:
"watercolours with flowers in the title" -> title="flower", classification="Drawings", medium="watercolor"
"show me something at random from the collection" -> sort="random", limit=3
Notes:
Medium spellings follow US usage ("watercolor", "color").
Date is free text ("1915-1931, printed 1976-1977"), so filter loosely and check results.
Inputs: date, page, sort, limit, +7 more. Returns: note, page, count, total, +4 more
whitney_search_eventsSearch Whitney eventsARead-onlyIdempotent
Search Museum events — talks, tours, public programmes and so on — going back to 2008. This list is largely comprehensive.
Args:
title (string, optional): substring match
filters (object, optional): raw Ransack predicates
sort (string, optional): e.g. 'start_time desc'
starts_on_or_after / starts_on_or_before (string, optional): ISO dates (YYYY-MM-DD) filtering on start_time
page (number, default 1), limit (number, 1-30, default 10)
response_format ('markdown' | 'json', default 'markdown')
Returns: { total, count, page, has_more, next_page?, results[] }
As with exhibitions, fields are passed through generically. Sort by 'start_time desc' for the most recent programming.
Inputs: page, sort, limit, title, +4 more. Returns: note, page, count, total, +4 more
whitney_search_exhibitionsSearch Whitney exhibitionsARead-onlyIdempotent
Search exhibitions mounted by the Whitney, going back to 1931. Records are fuller for recent decades and sparse for the Museum's early history.
Args:
title (string, optional): substring match
filters (object, optional): raw Ransack predicates for fields this tool does not expose
sort (string, optional): e.g. 'start_time desc', 'random'
starts_on_or_after / starts_on_or_before (string, optional): ISO dates (YYYY-MM-DD) filtering on start_time
page (number, default 1), limit (number, 1-30, default 10)
response_format ('markdown' | 'json', default 'markdown')
Returns: { total, count, page, has_more, next_page?, results[] }
Exhibition fields are passed through generically — the Museum documents its field set as subject to change, so this tool keeps whatever scalar fields the API returns, strips HTML, shortens timestamps to dates and drops internal IDs. Known fields include title, start_time, end_time, date_override, url, primary_text, press_highlights and popularity. Run one search with limit=1 to confirm before writing a 'filters' query.
Inputs: page, sort, limit, title, +4 more. Returns: note, page, count, total, +4 more
whitney_search_guidesSearch Whitney audio guidesARead-onlyIdempotent
Search audio guides published since 2009. Fetching an individual guide also returns its stops.
Args:
title (string, optional), filters (object, optional), sort (string, optional)
page (number, default 1), limit (number, 1-30, default 10)
response_format ('markdown' | 'json', default 'markdown')
Returns: { total, count, page, has_more, next_page?, results[] }
Inputs: page, sort, limit, title, +2 more. Returns: note, page, count, total, +4 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each resource has a clear search/get or relationship tool, and the overlap between whitney_artist_artworks and whitney_search_artworks is explicitly resolved in the descriptions. whitney_query is positioned as an escape hatch for unsupported queries, not as a competing primary tool.
The whitney_ prefix with search_/get_ resource names forms a clear pattern for most tools. The exceptions are whitney_artist_artworks and whitney_artist_exhibitions, which use a possessive noun style rather than a verb_noun style, and whitney_query, which is a one-off.
11 tools is well-scoped for a museum API covering artists, artworks, exhibitions, events, and guides, plus relationship helpers and a query escape hatch. Each tool has a distinct job and none feel redundant.
Core read-only workflows are covered: search and detail retrieval exist for artworks, artists, and exhibitions, and searches exist for events and guides. The main gap is the lack of typed getters for individual events and guides, which the guide description implies should exist; whitney_query can work around this but it is less discoverable.
Related MCP Connectors
Art Institute of Chicago MCP — wraps the ARTIC public API (free, no auth)
Victoria and Albert Museum (V&A) Collections MCP. Keyless. Wraps the V&A Collections API v2.
Unlock a world of art with the Met Museum MCP! Use the 'search_artworks' API to find stunning
Search and manage your team's knowledge from MCP clients.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceInteract with the Cooper Hewitt API with MCP.2MIT
- AlicenseNot gradedqualityDmaintenanceProvides structured access to Wikipedia content including search, summaries, images, links, and more via MCP tools.6Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables searching and retrieving details from the Harvard Art Museums collection.79 npm2MIT
- AlicenseNot gradedqualityCmaintenanceEnables searching the Metropolitan Museum of Art collection by subject, artist, or keyword, retrieving detailed artwork information, and listing curatorial departments via natural language.93 npm3MIT