Met Museum MCP Server

Met Museum MCP サーバー

自然言語でのやり取りを通じて、メトロポリタン美術館のコレクションにアクセスできる Model Context Protocol（MCP）サーバーです。このサーバーを使うと、AI モデルが The Met の美術品コレクションを検索し、ツールの結果を通じて作品の詳細（画像を含む）を取得できます。

目次

• 機能
  • 部門一覧の取得
  • 美術館の収蔵品を検索
  • 美術館の収蔵品を取得
  • Met Explorer アプリを開く
• MCP アプリ
• 前提条件
• クイックスタート
• 設定
• トランスポート
  • ストリーミング可能な HTTP トランスポート
• ChatGPT での使用方法
• Claude Desktop での使用方法
• LibreChat での使用方法
• クエリの例
• 開発
• コントリビューション
• ライセンス
• 免責事項

ホスト型デプロイ

ホスト型デプロイはFronteir AIで利用できます。

機能

このサーバーは、The Met の美術品コレクションを利用するために、AI モデルに次のツールを提供します。

1. 部門一覧の取得（list-departments）

The Met にあるすべての有効な部門を一覧表示します。

• 入力：
  • なし
• 出力：

  Department ID: 1, Display Name: American Decorative Arts
  Department ID: 3, Display Name: Ancient Near Eastern Art
  ...
  

2. 美術館の収蔵品を検索（search-museum-objects）

入力に基づいて、The Met にあるさまざまな収蔵品を検索します。

• 入力：

  • q（文字列）：検索語。例：ひまわり
  • hasImages（ブール値、任意、既定値：false）：画像のある収蔵品のみを検索します
  • title（ブール値、任意、既定値：false）：クエリに一致する収蔵品を返します。収蔵品のタイトルフィールドを対象に検索します。
  • departmentId（数値、任意）：特定の部門に属する収蔵品を返します。
  • page（数値、任意、既定値：1）：結果のページ番号（1から始まります）。
  • pageSize（数値、任意、既定値：24）：1ページあたりの収蔵品 ID 数（最大100）。

• 出力：

  Total objects found: 54
  Page: 1/3
  Object IDs: 436532, 789578, 436840, 438722,...
  

3. 美術館の収蔵品を取得（get-museum-object）

その収蔵品の画像（Open Access で利用可能な場合）を含む、オープンアクセスデータ全般を取得します。

画像があり、returnImage が true の場合、ツールの結果に画像コンテンツブロック（base64 エンコードされた JPEG）として返されます。

特定の作品について詳しい情報を求められ、すでに objectId がわかっている場合にこのツールを使用してください。

• 入力：
  • objectId（数値）：取得する収蔵品の ID
  • returnImage（ブール値、任意、既定値：true）：収蔵品の画像（利用可能な場合）をツールの結果に含めるかどうか
• 出力：

  Title: Self-Portrait with a Straw Hat (obverse: The Potato Peeler)
  Artist: Vincent van Gogh
  Artist Bio: Dutch, Zundert 1853–1890 Auvers-sur-Oise
  Department: European Paintings
  Credit Line: Bequest of Miss Adelaide Milton de Groot (1876-1967), 1967
  Medium: Oil on canvas
  Dimensions: 16 x 12 1/2 in. (40.6 x 31.8 cm)
  Primary Image URL: https://images.metmuseum.org/CRDImages/ep/original/DT1502_cropped2.jpg
  Tags: Men, Self-portraits
  

  returnImage が true の場合

  **base64 encoding of jpeg image**
  

4. Met Explorer アプリを開く（open-met-explorer）

インタラクティブな MCP アプリ（ui://met/explorer.html）を起動します。Apps に対応した MCP クライアント内で、オブジェクトを検索、絞り込み、詳しく調べることができます。

おすすめの使い方：

• open-met-explorer を使って起動し、検索結果をリアルタイムで表示します（すぐに検索を開始するには q を渡します）。

• 現在の検索結果から絞り込んだリストを作成した後は、ユーザーが詳しく調べたいアイテムに限り get-museum-object を使用します。

• 入力（すべて省略可能）：

  • q（string）：初期検索語。
  • hasImages（boolean、デフォルト：true）：画像があるオブジェクトを優先します。
  • title（boolean、デフォルト：false）：タイトルのみを検索します。
  • departmentId（number）：部署フィルターを事前に選択します。

• 出力：

  Opens the Met Explorer app in the client UI.
  

MCP アプリ

▶️ クリックしてデモ動画を見る

この MCP サーバーでは、MCP アプリを利用できるようになりました。Open Met Explorer App ツールと Get Museum Object ツールには、UI コンポーネントが用意されています。

前提条件

• Node.js v18 以降

クイックスタート

インストール不要で、npx を使ってサーバーを直接実行できます。

npx -y metmuseum-mcp

これにより、ほとんどの MCP デスクトップクライアントが想定する stdio トランスポートを使ってサーバーが起動します。

クライアントごとの設定については、以下を参照してください。

• Claude Desktop での使用方法
• ChatGPT での使用方法（Streamable HTTP トランスポートが必要です）
• LibreChat での使用方法

設定

以下の環境変数は、すべてのトランスポートに適用されます。

変数	デフォルト	説明
MET_API_TIMEOUT_MS	10000	Met Collection API への送信リクエストのタイムアウト時間（ミリ秒）。
MET_API_DEBUG	false	スキーマ検証に失敗した場合、stderr にデバッグログを出力します（真として扱われる値：1、true、yes、on）。

トランスポート

このサーバーは、次の 2 種類のトランスポートをサポートしています。

• stdio トランスポート（デフォルト）： MCP デスクトップクライアント（Claude Desktop、LibreChat MCP など）で使用されます。
• Streamable HTTP トランスポート： --http を指定して実行すると、/mcp に MCP エンドポイントが公開されます。

Streamable HTTP トランスポート

npx を使って実行します（エンドユーザーに推奨）。

npx -y metmuseum-mcp --http

または、ローカルクローンから実行します。

pnpm run build
node dist/index.js --http

サーバーは以下のアドレスで待ち受けます。

http://localhost:3001/mcp

環境変数を使って HTTP サーバーの動作を制御できます。

変数	デフォルト	説明
PORT	3001	Streamable HTTP サーバーが使用する HTTP ポート。
HOST	127.0.0.1	HTTP サーバーがバインドするネットワークインターフェイス。
ALLOWED_HOSTS	localhost,127.0.0.1	ホストヘッダー検証に使う、カンマ区切りの許可ホストリスト（例：localhost,127.0.0.1,my-domain.com）。

例：

HOST=127.0.0.1 PORT=8080 ALLOWED_HOSTS=localhost,127.0.0.1 npx -y metmuseum-mcp --http

ChatGPT での使用方法

以下の手順で、ChatGPT のウェブ UI から Met Museum MCP を使用できます。

1. ChatGPT で開発者モードを有効にする

設定 → アプリ → 詳細設定 → 開発者モード

追加の手順はこちらをご覧ください。

2. Streamable HTTP トランスポートで Met Museum MCP サーバーを実行する

npx -y metmuseum-mcp --http

デフォルトでは、サーバーは http://127.0.0.1:3001/mcp でリッスンします。

3. ローカルトンネルを作成して、MCP サーバーを ChatGPT に公開する

ngrok にサインアップして設定してください。無料プランで問題ありません。

ngrok http http://127.0.0.1:3001 --host-header=rewrite

転送先 URL を控えておいてください。

...
Forwarding                    https://john-joe-asdf.ngrok-free.dev -> http://localhost:3001
...

4. Met Museum MCP を ChatGPT のコネクターとして追加する

ChatGPT アプリの設定を開きます。

「アプリ」をクリックします。

「アプリを作成」をクリックします。

手順 3 の URL を MCP サーバー URL として使用し、末尾に /mcp を追加してフォームに入力します。

https://john-joe-asdf.ngrok-free.dev/mcp

認証では「認証なし」を選択します。

「内容を理解したうえで続行する」にチェックを入れます。

その後、「作成」をクリックします。

5. Met Museum MCP サーバーを使用する

プロンプト入力欄で、@name-of-server-from-step3 を使用するか、 ChatGPT の UI で「＋」ボタンをクリックし、「その他…」までスクロールして、新しく作成した Met アプリを選択し、クエリを入力します。

Claude Desktop での使用方法

MCP バンドル（MCPB）経由

1. リリースから mcpb ファイルをダウンロードします。
2. Claude Desktop で開きます。 または 「ファイル」→「設定」→「拡張機能」に移動し、.mcpb ファイルをウィンドウにドラッグしてインストールします。

npx 経由

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "met-museum": {
      "command": "npx",
      "args": [
        "-y",
        "metmuseum-mcp"
      ]
    }
  }
}

LibreChat での使用方法

librechat.yaml に以下を追加します。

mcpServers:
  metmuseum:
    command: npx
    args:
      - -y
      - metmuseum-mcp

クエリの例

このサーバーに接続したときに、AI モデルに質問できる内容の例を以下に示します。

Can you help me explore the works of Vincent Van Gogh?
Can you help me explore the Met?
Can you show me a few paintings from the Asian Art department?
Can you find the painting titled "Corridor in the Asylum"?
Can you find any art that has "cat" in the title or features "cats"?

開発

このプロジェクトでは、ローカル開発と CI に pnpm を使用します。

corepack enable
pnpm install
pnpm run build
pnpm run check

対話型でないシェルや CI ランナーでは、CI=true pnpm install --frozen-lockfile を使用してください。

コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

ライセンス

この MCP サーバーは MIT ライセンスの下でライセンスされています。つまり、MIT ライセンスの利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリ内の LICENSE ファイルをご覧ください。

免責事項

このライブラリは、ニューヨークの The Metropolitan Museum of Art と公式に関連していません。これは、The Metropolitan Museum of Art Collection API を MCP サーバーで利用するサードパーティーによる実装です。