README.md•4.51 kB
[](https://www.metmuseum.org/)
# 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.
<a href="https://glama.ai/mcp/servers/@mikechao/metmuseum-mcp"><img width="380" height="200" src="https://glama.ai/mcp/servers/@mikechao/metmuseum-mcp/badge" alt="Met Museum MCP Server" /></a>
[](https://mseep.ai/app/mikechao-metmuseum-mcp)
[](https://mseep.ai/app/ccc75a48-9b33-4a9a-8ef7-8dc3848db263)
## 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
## Via Desktop Extension (DXT)
1. Download the `dxt` file from the [Releases](https://github.com/mikechao/metmuseum-mcp/releases)
2. Open it with Claude Desktop
or
Go to File -> Settings -> Extensions and drag the .DXT file to the window to install it
## Via npx
Add this to your `claude_desktop_config.json`:
```json
{
"mcp-servers": {
"met-museum": {
"command": "npx",
"args": [
"-y",
"metmuseum-mcp"
]
}
}
}
```
### Usage with LibreChat
Add the following in your `librechat.yaml`
```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](https://metmuseum.github.io/) with a MCP Server.