Rijksmuseum Amsterdam MCP Server

This project implements a Model Context Protocol (MCP) server that interfaces with the Rijksmuseum API. It allows you to search for artworks, retrieve detailed information about specific artworks, access image tiles for artworks, and explore user-created collections from Amsterdam's famous Rijksmuseum.

<a href="https://glama.ai/mcp/servers/4rmiexp64y"><img width="380" height="200" src="https://glama.ai/mcp/servers/4rmiexp64y/badge" alt="Rijksmuseum Server MCP server" /></a>

Features

• Search Artworks: Find artworks in the Rijksmuseum collection using search terms
• Artwork Details: Retrieve detailed information about a specific artwork
• Artwork Images: Access image tiles for high-resolution views of artworks
• User Collections: Explore collections created by users in Rijksstudio
• User Collection Details: Get detailed information about a specific user collection
• Open Images in Browser: Directly open artwork images in your system's default web browser
• Artist Timelines: Create chronological timelines of an artist's works

Prerequisites

• Node.js v18 or higher
• An API key from the Rijksmuseum (get one here: https://data.rijksmuseum.nl/docs/api/)

Installation

1. Clone the repository:
   git clone <repository-url> cd <repository-directory>
2. Install dependencies:
   npm install
3. Build the project:
   npm run build

Configuration

Environment Variables

Create a .env file in the root directory with your Rijksmuseum API key:

Claude Desktop Integration

To use this server with Claude Desktop:

1. Locate your Claude Desktop configuration file:
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %AppData%\Claude\claude_desktop_config.json
2. Add the server configuration:
   { "mcpServers": { "rijksmuseum": { "command": "node", "args": ["/absolute/path/to/build/index.js"], "env": { "RIJKSMUSEUM_API_KEY": "your-api-key-here" } } } }
   Replace /absolute/path/to/build/index.js with the absolute path to the built JavaScript file in your project's build directory.
3. Restart Claude Desktop for the changes to take effect.

Available Tools

The server provides several tools that can be accessed through MCP clients:

search_artwork

Search for artworks using a query string.

get_artwork_details

Retrieve detailed information about an artwork using its object number.

get_artwork_image

Get image tiles for an artwork using its object number.

get_user_sets

List user-created collections.

get_user_set_details

Retrieve details about a specific user collection.

open_image_in_browser

Open an artwork's image URL directly in your default web browser.

get_artist_timeline

Create a chronological timeline of an artist's works.

Available Prompts

The server provides prompt templates for common tasks:

analyze-artwork

Generate a detailed analysis of an artwork's composition, style, and historical context.

generate-artist-timeline

Create a visual timeline showing the chronological progression of an artist's works.

Available Resources

The server provides access to curated collections:

art://collection/popular

Access the most viewed artworks in the collection.

Example Queries for Claude

Here are some natural language queries you can use with Claude to interact with the tools:

Searching and Exploring

Detailed Information

Images and Visualization

Artist Timelines and Analysis

Combined Queries

Error Handling

The server implements standard MCP error handling:

• Invalid requests return appropriate error codes and messages
• API errors are properly formatted and passed through to the client
• Network issues are handled gracefully with informative error messages

Development

Building from Source

1. Make changes to the source code in the src directory
2. Build the project:
   npm run build
3. The built files will be in the build directory

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run the tests
5. Submit a pull request

License

This project is licensed under the MIT License. See the LICENSE file for details.