whitney-museum-mcp-server

ホイットニー美術館の公開APIのためのMCPサーバーです。Claude Desktopや任意のMCPクライアントから、コレクション、アーティスト、展覧会、イベント、オーディオガイドを検索できます。

アメリカン・アートのホイットニー美術館とは提携していません。これは、https://whitney.org/about/website/api に文書化されている公開APIをラップするサードパーティ製のラッパーです。

ホイットニーのAPIはオープンで認証不要のため、APIキーは必要ありません。

Install

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を終了して再起動してください。設定では ~ は展開されないため、フルパスを使用してください。

Tools

What to expect

検索結果は簡潔なレコードです。 ホイットニーのレコードには長いHTMLの説明や伝記が含まれるため、検索では基本情報を返し、whitney_get_* で完全な情報を返します。散文は2,000文字、レスポンス全体は25,000文字で切り詰められます。

ページネーションは1ページ30件です。 これはAPIのページサイズです。page でページを選択し、limit でさらに絞り込みます — デフォルトの10件は、広範な検索でコンテキストが溢れるのを防ぎます。

検索構文はRansackです。 述語は q の下にネストします（_eq、_cont、_cont_all_split、_gteq など）。並べ替えは q[s] の下です。型付きツールは親しみやすい引数をこれらにマッピングします。whitney_query は、型付きツールが届かないもののために、それらを生のまま公開します。

アーティストと作品のフィールドは明示的にマッピングされています。 展覧会、イベント、ガイド、ページは代わりに汎用サマライザーを通過します：HTMLは除去され、タイムスタンプは日付に短縮され、相対URLは絶対URLに変換され、内部外部キーは削除されます。美術館はフィールドセットが変更される可能性があると述べているため、必要でないものはハードコードされていません。limit: 1 で検索を実行して実際のフィールド名を確認し、特定のものには filters を使用してください。

Known quirks

これらはAPIのものであり、ラッパーのものではありません。

• sort: "random" は確実にランダム化されません。3つのランダムな作品を要求すると、同じアーティストによる連続した3つの受入番号が返されました。真のランダム性が必要な場合は、代わりにランダムなページ番号を要求してください。

• 作品の display_date は自由テキストです — "1915–1931, printed 1976–1977" — そのため日付範囲は機能しません。展覧会とイベントには実際のタイムスタンプがあり、starts_on_or_after / starts_on_or_before でフィルタリングできます。

• 存命のアーティストは death_year: "0" を持ちます。これで算術演算をしないでください。

• Ransackは認識できない述語をエラーにするのではなく無視するため、スペルミスのフィールドは静かにすべてを返します。結果の件数を確認してください。

Bulk data

大規模なものには、APIをページングしないでください。ホイットニーは、https://github.com/whitneymuseum/open-access でアーティストと作品のCSVを公開しており、CC0でリリースされています。

Fun things to do

Getty ULANとWikidataのMCPを使用して、ホイットニーのレコードと他の美術館の間のつながりを、あなたのフレンドリーロボットに作らせましょう。

（私はこれらすべてを使って、自分の教育・研究ノートにリンクやより豊かな情報を追加しています。）

Licences

コードはMITライセンスで公開されています — LICENSE を参照してください。

基盤となるデータはホイットニーに帰属します。APIを通じてアクセスした素材は、著作権やその他の制限の対象となる場合があります。ホイットニーは、著作権表示を保持し、著者と出典を引用することを条件に、非営利の教育目的および個人使用、さらにフェアユースを許可しています。公開するものを構築する前に、https://whitney.org/about/website/api で利用規約を読んでください。

上記のCSVデータセットはCC0であり、APIの利用規約よりも寛容です。同じデータでも、入口が異なります。

Thank you

ホイットニーのデジタルチームに、APIを公開し、適切に文書化してくれたことに感謝します。あなたたちは最高に素晴らしい人たちです。