Rijksmuseum

@pipeworx/rijksmuseum

Rijksmuseum の約 800,000 点のコレクション――オランダ黄金時代の絵画、版画、素描、写真、デルフト焼、アジア美術――を、同館のオープン Data Services API から利用できます。IIIF 画像を提供し、権利の大半はパブリックドメインです。

Pipeworx の一部です。AI エージェントを 1683 以上のライブデータソースにつなぐ MCP ゲートウェイです。

ツール

• rijks_search(...) — タイトル、作者、種類、素材、技法、作品番号、画像の有無で検索します。ID だけでなく、詳細情報を取得したレコードを返します。
• rijks_object(id | object_number) — 美術館独自のキュレーターによる説明を含む、作品 1 点の全情報を返します。
• rijks_object_image(id, width) — IIIF サービス、フル解像度の寸法、フルサイズ・縮小サイズ・サムネイルの JPEG URL、権利表記を返します。

認証

キーは不要です。

Rijksmuseum の API は 2 種類あり、オープンなのはこの API だけです。 レガシーの www.rijksmuseum.nl/api には Rijksstudio アカウントごとに発行されるキーが必要です。 ここで使用する data.rijksmuseum.nl には認証情報は必要ありません。

データソース

• https://data.rijksmuseum.nl/search/collection — フィールドを指定して検索します。識別子のみを返します。
• https://data.rijksmuseum.nl/{id}?_profile=dc — Dublin Core レコード（約 4 KB）。
• https://data.rijksmuseum.nl/{id} — Linked Art の完全な JSON-LD（約 95 KB）。

次の担当者が同じことを調べ直さずに済むよう、注意点を記します。

• 検索結果は URI のみです。 1 ページには https://id.rijksmuseum.nl/<n> という文字列が 100 件と合計数が含まれます。タイトルも画像もありません。rijks_search は返された各結果に追加で 1 回リクエストして詳細情報を取得するため、limit は最大 25 に制限されています。
• デフォルトの Linked Art ではなく _profile=dc を使ってください。 Linked Art では、タイトルは identified_by の 3 階層下にあり、画像は shows → VisualItem → digitally_shown_by → DigitalObject のチェーンの先にあります（さらに 3 回のリクエストが必要です）。Dublin Core ではすべてがフラットにまとまっており、relation に IIIF URL も含まれます。サイズは約 1/20 です。
• 未対応のクエリパラメーターは、名前を指定して拒否されます（{"detail":"Unsupported query parameter: q"}）。自由入力の q はありません。受け付けられることを確認済みのパラメーターは、title、creator、type、material、technique、objectNumber、imageAvailable です。レコードのフィールドとして subject が存在しますが、subject は受け付けられません。
• タイトルはオランダ語で登録されています。 title=Nachtwacht で The Night Watch が見つかりますが、title=Night Watch では見つかりません。
• objectNumber は正確に解決されます（SK-C-5 → 200107928）。そのため、rijks_object は美術館の作品番号を受け付け、検索によって解決します。
• 画像は IIIF Image API 3、レベル 2 で、iiif.micr.io から配信されます。iiif_service では任意の領域・サイズ・回転をリクエストできます。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "rijksmuseum": {
      "url": "https://gateway.pipeworx.io/rijksmuseum/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/rijksmuseum/mcp の tools/list は、上の表にあるツールに加えて、共有の Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール一式）を返します。そのため、表示されるツール数はこの表より多くなります。単一パックのエンドポイントには現在、パック独自のツールとあわせて約 30 個の共有ツールが表示されます。initialize の応答には正確なスコープが記載されており、その日の状況を確認するうえで最も信頼できる情報です。

これは意図的な仕様であり、偶然に多重化されているわけではありません。メタツールを使うと、このパックの対象外の質問にも、カタログ全体を横断する ask_pipeworx 経由で回答できます。そのため、MCP サーバーを 2 つ目に追加する必要はありません。現在、メタツールを含めずにパックのエンドポイントを接続する方法はありません。追加スキーマによって消費されるコンテキストがルーティングの利便性を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1683 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合は、HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/rijks_search \
  -H 'Content-Type: application/json' \
  -d '{"creator":"Rembrandt van Rijn","type":"painting","limit":3}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/rijks_search を実行します。ツールを見つけるには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "rijksmuseum": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-rijksmuseum"]
    }
  }
}

または、直接実行して起動することを確認します。

npx -y @pipeworx/mcp-rijksmuseum

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続によって追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、ゲートウェイ全体でも利用できます。

ask_pipeworx({ question: "your question about Rijksmuseum data" })

ゲートウェイが適切なツールを選び、引数を自動的に入力します。

さらに詳しく

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT