Rijksmuseum MCP

🚀 Rijksmuseum MCP Server

A Model Context Protocol (MCP) server that provides access to the Rijksmuseum collection through natural language interaction. This server enables AI models to explore, analyze, and interact with the Rijksmuseum's artworks and collections.

✨ Features

This server offers a variety of tools for interacting with the Rijksmuseum collection:

1. Search Artwork (search_artwork)

Search and filter artworks using various criteria, including:

• Text search
• Artist names
• Artwork types
• Materials and techniques
• Time periods
• Colors
• And more

2. Artwork Details (get_artwork_details)

Retrieve detailed information about specific artworks, including:

• Basic information (title, artist, date)
• Physical characteristics
• Historical background
• Visual information
• Curatorial information
• Exhibition history

3. High-Resolution Images (get_artwork_image)

Access high-resolution image data and deep zoom functionality:

• Multiple zoom levels
• Tiled image loading
• Full-resolution support
• Location information

4. User Collections (get_user_sets & get_user_set_details)

Explore user-created collections:

• Browse curated collections
• View thematic groupings
• Analyze user collections
• And more

5. High-Resolution Image Access

The high-resolution image feature allows you to view artwork details in high quality.

6. User Collection Browsing

Use get_user_sets and get_user_set_details to explore and analyze user collection information.

💻 Usage Examples

Here are some example queries for using this server:

- Show me all paintings by Rembrandt from the 1640s: `Show me all paintings by Rembrandt from the 1640s`
- Give me details about Van Gogh's Starry Night: `Give me details about Van Gogh's Starry Night`
- Browse through my collection of sculptures: `Browse through my collection of sculptures`

🚀 Quick Start

There are two ways to install and configure this server:

Method 1: Via Claude Desktop

1. Download and install Claude Desktop.
2. Open Claude Desktop and go to the "Settings" menu.
3. Select the "MCP Server" option.
4. Add a new MCP server and specify the following information:
   • Name: rijksmuseum-server
   • Command: node
   • Parameters: /path/to/rijksmuseum-server/build/index.js

Method 2: Install from Source Code

1. Clone this repository to your local computer.
2. Open a terminal and navigate to the repository directory.
3. Install the dependencies:

   npm install
   

4. Configure the environment variables:

   RIJKSMUSEUM_API_KEY=your_api_key_here
   PORT=3000
   LOG_LEVEL='info'
   

5. Start the server:

   npm start
   

📚 Documentation

Configure this server using the following environment variables:

• RIJKSMUSEUM_API_KEY: Your Rijksmuseum API key (required)
• PORT: Server port (default: 3000)
• LOG_LEVEL: Log level (default: 'info')

📄 API Documentation

For detailed information about the Rijksmuseum API endpoints used by this server, please visit: Rijksmuseum API Documentation

🔧 Contribution

Contributions are welcome! Please feel free to submit pull requests or create issues for bugs and feature requests.

📄 License

This project is released under the MIT License. Please refer to the LICENSE file for details.