whitney-museum-mcp-server

Ein MCP-Server für die öffentliche API des Whitney Museums. Durchsuchen Sie die Sammlung, Künstler:innen, Ausstellungen, Veranstaltungen und Audioguides von Claude Desktop oder einem beliebigen MCP-Client aus.

Nicht mit dem Whitney Museum of American Art verbunden. Dies ist ein Drittanbieter-Wrapper um deren öffentliche API, dokumentiert unter https://whitney.org/about/website/api.

Sie benötigen keinen API-Schlüssel, da die API des Whitney offen und ohne Authentifizierung zugänglich ist.

Installation

npx whitney-museum-mcp-server

Oder aus dem Quellcode:

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

Node 20 oder neuer.

Claude Desktop

Fügen Sie Folgendes zu claude_desktop_config.json hinzu:

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

Aus dem Quellcode zeigen Sie stattdessen auf den Build:

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

Beenden und öffnen Sie Claude Desktop neu. Die Konfiguration expandiert ~ nicht, verwenden Sie also einen vollständigen Pfad.

Tools

Was Sie erwarten können

Die Suche liefert schlanke Datensätze. Whitney-Datensätze enthalten lange HTML-Beschreibungen und Biografien, daher liefert die Suche die Grundlagen und whitney_get_* alles Weitere. Prosa wird bei 2.000 Zeichen abgeschnitten, ganze Antworten bei 25.000.

Die Paginierung beträgt 30 pro Seite. Das ist die Seitengröße der API. page wählt die Seite, limit begrenzt sie weiter — der Standardwert von 10 verhindert, dass eine breite Suche Ihren Kontext überflutet.

Die Suchsyntax ist Ransack. Prädikate verschachteln sich unter q (_eq, _cont, _cont_all_split, _gteq und Verwandte), Sortierung unter q[s]. Die typisierten Tools bilden benutzerfreundliche Argumente darauf ab. whitney_query legt sie roh offen, für alles, was die typisierten Tools nicht erreichen.

Künstler:innen- und Werkfelder werden explizit zugeordnet. Ausstellungen, Veranstaltungen, Guides und Seiten durchlaufen stattdessen einen generischen Zusammenfasser: HTML wird entfernt, Zeitstempel auf Daten gekürzt, relative URLs absolut gemacht, interne Fremdschlüssel verworfen. Das Museum sagt, dass sich sein Feldsatz ändern kann, daher ist nichts hartcodiert, was nicht hartcodiert sein muss. Führen Sie eine Suche mit limit: 1 aus, um die tatsächlichen Feldnamen zu sehen, und verwenden Sie dann filters für alles Spezifische.

Bekannte Eigenheiten

Diese stammen von der API, nicht vom Wrapper.

• sort: "random" randomisiert nicht zuverlässig. Die Anfrage nach drei zufälligen Werken lieferte drei aufeinanderfolgende Inventarnummern derselben Künstler:in. Wenn Sie echte Zufälligkeit benötigen, fragen Sie stattdessen eine zufällige Seitennummer ab.

• display_date bei Kunstwerken ist Freitext — „1915–1931, printed 1976–1977" — daher funktionieren Datumsbereiche dort nicht. Ausstellungen und Veranstaltungen haben echte Zeitstempel, und starts_on_or_after / starts_on_or_before filtern darauf.

• Lebende Künstler:innen haben death_year: "0". Rechnen Sie nicht damit.

• Ransack ignoriert Prädikate, die es nicht erkennt, anstatt einen Fehler zu werfen. Ein falsch geschriebenes Feld gibt daher stillschweigend alles zurück. Prüfen Sie Ihre Ergebnismengen.

Massendaten

Für alles in großem Umfang sollten Sie nicht durch die API blättern. Das Whitney veröffentlicht Künstler:innen- und Werk-CSVs unter https://github.com/whitneymuseum/open-access, veröffentlicht unter CC0.

Lustige Dinge zum Ausprobieren

Lassen Sie Ihren freundlichen Roboter Verbindungen zwischen Whitney-Datensätzen und anderen Museen herstellen, indem Sie die Getty-ULAN- und Wikidata-MCPs verwenden.

(Ich verwende all diese, um Links und reichhaltigere Informationen zu meinen Lehr- / Forschungsnotizen hinzuzufügen.)

Lizenzen

Der Code wird unter MIT veröffentlicht — siehe LICENSE.

Die zugrunde liegenden Daten gehören dem Whitney. Material, das über die API abgerufen wird, kann durch Urheberrecht und andere Beschränkungen geschützt sein. Das Whitney erlaubt nichtkommerzielle Bildungs- und persönliche Nutzung sowie faire Nutzung, sofern Urheberrechtshinweise erhalten bleiben und Autor:in und Quelle zitiert werden. Lesen Sie deren Bedingungen unter https://whitney.org/about/website/api, bevor Sie etwas Öffentliches darauf aufbauen.

Beachten Sie, dass die oben verlinkten CSV-Datensätze CC0 sind, was großzügiger ist als die API-Bedingungen. Gleiche Daten, andere Tür.

Danke

An das Digitalteam des Whitney für die Veröffentlichung einer API überhaupt und für die ordentliche Dokumentation. Ihr seid wirklich die Allerbesten.