DISCLAIMER

DISCLAIMER

By shenhai-ran GitHub

MCP server for Rijksmuseum OAI-PMH API

rijksmuseum oai-pmh
Overview

What is Rijksmuseum MCP OAI-PMH?

Rijksmuseum MCP OAI-PMH is a Model Context Protocol (MCP) server implementation for the Rijksmuseum OAI-PMH API, allowing access to the museum's rich collection data using the MCP protocol.

How to use Rijksmuseum MCP OAI-PMH?

To use the server, clone the repository, install dependencies, and start the server. You can then access various endpoints to interact with the museum's data.

Key features of Rijksmuseum MCP OAI-PMH?

  • Implements all major OAI-PMH verbs as MCP tools.
  • Simple RESTful API following MCP standards.
  • Comprehensive error handling.
  • TypeScript implementation.

Use cases of Rijksmuseum MCP OAI-PMH?

  1. Accessing museum collection data programmatically.
  2. Integrating museum data into applications.
  3. Conducting research on art collections.

FAQ from Rijksmuseum MCP OAI-PMH?

  • What protocols does the server support?

The server supports the OAI-PMH protocol through the MCP implementation.

  • Is there a license for using this server?

Yes, the project is licensed under the MIT License.

  • How can I contribute to the project?

You can contribute by submitting issues or pull requests on the GitHub repository.

Content

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.

No tools information available.
Rijksmuseum MCP Client for Rijksmuseum MCP Server

-

rijksmuseum mcp-client
View Details