Metmuseum MCP

🚀 Metropolitan Museum MCP Server

A Model Context Protocol (MCP) server that provides access to the Metropolitan Museum's collection through natural language interaction. This server allows AI models to search the museum's art collections and offers artworks as resources.

✨ Features

This server provides the following tools for AI models to interact with the Metropolitan Museum's art collection.

1. List Departments (list-departments)

List all valid departments of the Metropolitan Museum.

• Input:
  • None
• Output:

  Department ID: 1, Display Name: Department of American Decorative Arts
  Department ID: 3, Display Name: Department of Ancient Near Eastern Art
  ...
  

2. Search Museum Objects (search-museum-objects)

Search the Metropolitan Museum's collection based on the input.

• Input:
  • q (string): Search term, e.g., "Sunflowers"
  • hasImages (boolean, optional, default: false): Search only for objects with images.
  • title (boolean, optional, default: false): Return objects where the title field matches the query.
  • departmentId (number, optional): Return objects from a specific department.
• Output:

  Total number of objects found: 54
  Object IDs: 436532, 789578, 436840, 438722,...
  

3. Get Museum Object (get-museum-object)

Get a specific object from the Metropolitan Museum, including its open access data, and add an image (if available).

• Input:
  • objectId (number): The ID of the object to retrieve.
  • returnImage (boolean, optional, default: true): Whether to return an image of the object (if available).
• Output:

  Title: Self-Portrait with Straw Hat (front: Peeling Potatoes in the Asylum)
  Artist: Vincent van Gogh
  Artist Bio: Dutch, born in Zundert, 1853; died in Auvers-sur-Oise, 1890
  Department: European Paintings
  Accession Line: Bequest of Adelaide Milton de Groot (1876–1967), 1967
  Medium: Painting
  Dimensions: 73.5 x 60.2 cm (28 7/8 x 23 3/4 in.)
  Publications: 
    - Example: Metropolitan Museum of Art, The Met Collection, 2023.
  

  If returnImage is true, a link to the object's image will be returned.

💻 Usage Examples

Basic Usage

Example 1: List Departments

Execute the following command to list all departments of the Metropolitan Museum:

{
  "command": "list-departments"
}

Example 2: Search for Objects

Execute the following command to search for objects with the title "Sunflowers":

{
  "command": "search-museum-objects",
  "q": "Sunflowers"
}

Example 3: Get a Specific Object

Execute the following command to get information about the object with ID 436532:

{
  "command": "get-museum-object",
  "objectId": 436532
}

Advanced Usage

Integrate into an Application Using JSON Format

{
  "command": "search-museum-objects",
  "q": "Van Gogh"
}

Integrate into a Script Using YAML Format

command: get-museum-object
objectId: 789578
returnImage: true

📚 Documentation

Notes

• All requests require a valid API key.
• Image links are for preview purposes only. Please comply with relevant laws and regulations for commercial use.
• Call frequency may be limited. Please refer to the Metropolitan Museum's API documentation.

Project Address

GitHub Repository

About

This library is not officially affiliated with The Metropolitan Museum of Art. It is a third-party implementation of an MCP server for the Metropolitan Museum's collection API.