whitney-museum-mcp-server

Un servidor MCP para la API pública del Whitney Museum. Busca en la colección, artistas, exposiciones, eventos y guías de audio desde Claude Desktop o cualquier cliente MCP.

No está afiliado al Whitney Museum of American Art. Este es un envoltorio de terceros alrededor de su API pública, documentada en https://whitney.org/about/website/api.

No necesitas una clave de API, ya que la API del Whitney es abierta y no autenticada.

Instalación

npx whitney-museum-mcp-server

O desde el código fuente:

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

Node 20 o más reciente.

Claude Desktop

Añade a claude_desktop_config.json:

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

Desde el código fuente, apunta a la compilación en su lugar:

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

Sal y vuelve a abrir Claude Desktop. La configuración no expande ~, así que usa una ruta completa.

Herramientas

Qué esperar

La búsqueda devuelve registros reducidos. Los registros del Whitney contienen descripciones HTML largas y biografías, así que la búsqueda te da lo básico y whitney_get_* te da todo. El texto se trunca a 2.000 caracteres, y las respuestas completas a 25.000.

La paginación es de 30 por página. Ese es el tamaño de página de la API. page selecciona la página, limit la recorta aún más: el valor predeterminado de 10 evita que una búsqueda amplia inunde tu contexto.

La sintaxis de búsqueda es Ransack. Los predicados se anidan bajo q (_eq, _cont, _cont_all_split, _gteq y similares), y la ordenación bajo q[s]. Las herramientas tipadas asignan argumentos amigables a estos. whitney_query los expone sin procesar, para cualquier cosa que las herramientas tipadas no alcancen.

Los campos de artistas y obras se asignan explícitamente. Las exposiciones, eventos, guías y páginas pasan por un resumidor genérico en su lugar: se elimina el HTML, las marcas de tiempo se acortan a fechas, las URLs relativas se hacen absolutas, y se eliminan las claves externas internas. El Museo dice que su conjunto de campos puede cambiar, así que nada está codificado de forma rígida si no es necesario. Ejecuta una búsqueda con limit: 1 para ver los nombres de campo reales, y luego usa filters para cualquier cosa específica.

Particularidades conocidas

• sort: "random" no aleatoriza de forma fiable. Pedir tres obras aleatorias devolvió tres números de acceso consecutivos del mismo artista. Si necesitas aleatoriedad genuina, solicita un número de página aleatorio en su lugar.

• display_date en las obras es texto libre — "1915–1931, impreso 1976–1977" — así que los rangos de fechas no funcionan allí. Las exposiciones y eventos tienen marcas de tiempo reales, y starts_on_or_after / starts_on_or_before filtran sobre esas.

• Los artistas vivos tienen death_year: "0". No hagas aritmética con eso.

• Ransack ignora los predicados que no reconoce en lugar de dar error, así que un campo mal escrito devuelve todo silenciosamente. Comprueba los recuentos de resultados.

Datos masivos

Para cualquier cosa a gran escala, no hagas paginación a través de la API. El Whitney publica CSV de artistas y obras en https://github.com/whitneymuseum/open-access, publicados bajo CC0.

Cosas divertidas que hacer

Haz que tu robot amigable establezca conexiones entre los registros del Whitney y otros museos usando los MCP de Getty ULAN y Wikidata.

(Estoy usando todo esto para añadir enlaces e información más rica a mis notas de enseñanza / investigación).

Licencias

El código se publica bajo MIT — ver LICENSE.

Los datos subyacentes pertenecen al Whitney. El material accedido a través de la API puede estar protegido por derechos de autor y otras restricciones. El Whitney permite el uso educativo y personal no comercial, además del uso justo, siempre que se conserven los avisos de derechos de autor y se cite al autor y la fuente. Lee sus términos en https://whitney.org/about/website/api antes de construir algo público sobre ello.

Ten en cuenta que los conjuntos de datos CSV enlazados arriba son CC0, lo cual es más permisivo que los términos de la API. Mismos datos, puerta diferente.

Gracias

Al equipo digital del Whitney por publicar una API en primer lugar, y por documentarla adecuadamente. Sois unos encantadores de lo más excelente.