DISCLAIMER

All code in this repository is generated by Windsurf with AI and has not been human-checked at all.

Rijksmuseum OAI-PMH MCP Server

A Model Context Protocol (MCP) server implementation for the Rijksmuseum OAI-PMH API. This server allows you to access the Rijksmuseum's rich collection data using the MCP protocol.

Features

- Implements all major OAI-PMH verbs as MCP tools
- Identify → rijksmuseum_identify
- ListMetadataFormats → rijksmuseum_list_metadata_formats
- ListSets → rijksmuseum_list_sets
- ListRecords → rijksmuseum_list_records
- GetRecord → rijksmuseum_get_record
- Simple RESTful API following MCP standards
- Comprehensive error handling
- TypeScript implementation

Installation

# Clone the repository
git clone https://github.com/shenhai-ran/rijksmuseum-mcp-oaipmh.git
cd rijksmuseum-mcp-oaipmh
Install dependencies
npm install
Start the server
npm run dev

API Usage

The server exposes the following endpoints:

- GET / - Returns server information and available tools
- POST /tools/{toolName} - Executes a specific tool with the provided parameters

Examples

# Get information about the Rijksmuseum repository
curl -X POST http://localhost:3000/tools/rijksmuseum_identify
List metadata formats
curl -X POST http://localhost:3000/tools/rijksmuseum_list_metadata_formats
Get a specific record
curl -X POST http://localhost:3000/tools/rijksmuseum_get_record \
  -H "Content-Type: application/json" \
  -d '{"identifier": "https://id.rijksmuseum.nl/2001", "metadataPrefix": "oai_dc"}'

Development

# Run the server in development mode with hot reloading
npm run watch
Run the direct test against the Rijksmuseum API
npm run direct-test
Run the MCP test client against the local server
npm run mcp-test

License

MIT

About the Rijksmuseum API

The Rijksmuseum API provides access to the museum's collection data through various protocols, including OAI-PMH. For more information, visit Rijksmuseum API Documentation.