robotconscience/mma-mcp-mvp

mcp-metmuseum

Minimal MCP server that wraps The Met Collection API.

Tools

• list-departments → GET /departments
• search-objects → GET /search with Met filters
• get-object → GET /objects/{objectID}
• get-random-object → Random object with optional hasImages, isHighlight
• get-open-access → Returns up to max objects where isPublicDomain is true. For now, requires a query.
• get-object-image → Returns the primaryImage (or primaryImageSmall) for an object

Notes:

• search-objects returns basic info including objectIDs; use get-object for full metadata.
• get-open-access filters by isPublicDomain after fetching object details.

Quick start

npm i
npm run dev    # during development
# or:
npm run build && npm start

Claude Desktop config

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "metmuseum": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {}
    }
  }
}

Then restart the app and invoke tools like:

• Use metmuseum → list-departments
• Use metmuseum → search-objects with { "q": "Temple of Dendur", "hasImages": true, "max": 5 }
• Use metmuseum → get-object with { "objectID": 543123 }
• Use metmuseum → get-random-object with { "hasImages": true }
• Use metmuseum → get-open-access with { "q": "*", "max": 10 }
• Use metmuseum → get-object-image" with { "objectID": 436524 }`