Met Museum MCP Server

By mikechao GitHub

Met Museum MCP integration to discover the art collection at The Metropolitan Museum of Art in New York

art model-context-protocol

Overview

what is Met Museum MCP Server?

Met Museum MCP Server is a Model Context Protocol (MCP) server that provides access to the Metropolitan Museum of Art's collection through natural language interactions, allowing AI models to search and retrieve information about artworks.

how to use Met Museum MCP Server?

To use the Met Museum MCP Server, integrate it with your AI model by adding the provided configuration to your claude_desktop_config.json file. You can then query the server for information about artworks.

key features of Met Museum MCP Server?

List departments at The Met.
Search for museum objects based on various criteria.
Retrieve detailed information about specific artworks, including images and artist information.

use cases of Met Museum MCP Server?

Finding artworks from specific departments like Asian Art.
Searching for paintings by title or theme.
Integrating art collection data into AI applications for educational purposes.

FAQ from Met Museum MCP Server?

Is this server officially associated with The Metropolitan Museum of Art?

No, this is a third-party implementation of The Metropolitan Museum of Art Collection API.

What programming language is used for this server?

The server is implemented in TypeScript.

Can I contribute to this project?

Yes! Contributions are welcome, and you can submit a Pull Request.

Content

Met Museum MCP Server

A Model Context Protocol (MCP) server that provides access to the Metropolitan Museum of Art Collection through natural language interactions. This server allows AI models to search The Met's art collection and have art works available as a Resource.

Features

This server provides AI models the following tools to interact with the art collection of The Met

1. List Departments (list-departments)

Lists all the valid departments at The Met

Inputs:
- None

Output:

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

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

Search for various objects in The Met based on the inputs.

Inputs:
- q (string): The search term e.g. sunflowers
- hasImages (boolean, optional, default: false): Only search for objects with images
- title (boolean, optional, default: false): Returns objects that match the query, specifically searching against the title field for objects.
- departmentId (number, optional): Returns objects that are a part of a specific department.

Outputs:

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

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

Get a specific object from The Met containing all open access data about that object, including its image (if the image is available under Open Access).

If there is an image it is added to the Resource of the server via the title of the object.

Inputs:
- objectId (number): The id of the object to retrieve
- returnImage (boolean, optional, default: true): Whether to return the image (if available) of the object and add it to the server resources

Outputs:

Title: Self-Portrait with a Straw Hat (obverse: The Potato Peeler)
Artist: Vincent van Gogh
Artist Bio: Dutch, Zundert 1853–1890 Auvers-sur-Oise
Department: European Paintings
Credit Line: Bequest of Miss Adelaide Milton de Groot (1876-1967), 1967
Medium: Oil on canvas
Dimensions: 16 x 12 1/2 in. (40.6 x 31.8 cm)
Primary Image URL: https://images.metmuseum.org/CRDImages/ep/original/DT1502_cropped2.jpg
Tags: Men, Self-portraits

If returnImage is true

**base64 encoding of jpeg image**

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcp-servers": {
    "met-museum": {
      "command": "npx",
      "args": [
        "-y",
        "metmuseum-mcp"
      ]
    }
  }
}

Usage with LibreChat

Add the following in your librechat.yaml

mcpServers:
  metmuseum:
    command: npx
    args:
      - -y
      - metmuseum-mcp

Example queries

Here some questions you can ask the AI model when this server in connected:

Can you show me a few painting from the Asian Art department?
Can you find the painting titled "Corridor in the Asylum"?
Can you find any art that has "cat" in the title or features "cats"?

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Disclaimer

This library is not officially associated with The Metropolitan Museum of Art in New York. It is a third-party implementation of the The Metropolitan Museum of Art Collection API with a MCP Server.

No tools information available.