whitney-museum-mcp-server

휘트니 미술관(Whitney Museum) 공개 API용 MCP 서버입니다. Claude Desktop이나 모든 MCP 클라이언트에서 컬렉션, 작가, 전시, 이벤트, 오디오 가이드를 검색할 수 있습니다.

휘트니 미국 미술관(Whitney Museum of American Art)과 제휴 관계가 아닙니다. 이는 https://whitney.org/about/website/api에 문서화된 공개 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을 절대 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를 페이지 단위로 넘기지 마세요. 휘트니는 CC0로 공개된 작가 및 작품 CSV를 https://github.com/whitneymuseum/open-access에 게시합니다.

재미있는 작업

Getty ULAN 및 Wikidata MCP를 사용하여 친근한 로봇이 휘트니 기록과 다른 미술관 간의 연결을 만들게 하세요.

(저는 이 모든 것을 제 교육/연구 노트에 링크와 풍부한 정보를 추가하는 데 사용하고 있습니다.)

라이선스

코드는 MIT 라이선스로 공개됩니다 — LICENSE 참조.

기본 데이터는 휘트니의 소유입니다. API를 통해 접근한 자료는 저작권 및 기타 제한의 보호를 받을 수 있습니다. 휘트니는 저작권 표시를 유지하고 저자와 출처를 인용하는 조건으로 비상업적 교육 및 개인적 사용과 공정 이용을 허용합니다. 공개적으로 구축하기 전에 https://whitney.org/about/website/api에서 이용 약관을 읽으세요.

위에 링크된 CSV 데이터셋은 API 약관보다 더 허용적인 CC0입니다. 같은 데이터, 다른 문입니다.

감사의 말

API를 공개하고 제대로 문서화한 휘트니 디지털 팀에게 감사드립니다. 정말 훌륭한 분들입니다.