Cooper Hewitt Model Context Protocol (MCP) Server

Description

A Model Context Protocol (MCP) server for interacting with the Cooper Hewitt Museum’s collection API. This tool allows searching and retrieving detailed information about museum objects programmatically.

Prerequisites

Node.js (version 16+ recommended)
npm (Node Package Manager)

Installation

Clone the repository:


git clone https://github.com/behole/cooper-hewitt-mcp.git
cd cooper-hewitt-mcp

Install dependencies:


npm install

Set up API Token
- Create a .env file in the project root
- Obtain an API token from the Cooper Hewitt API
- Add your token to the .env file:
```
COOPER_HEWITT_API_TOKEN=your_api_token_here
```
Update your claude_desktop_config.json


"cooper-hewitt": {
      "command": "node",
      "args": ["path to your index.js"]
    }

Available Tools

Search Objects

Name: search-objects
Description: Search for objects in the Cooper Hewitt collection
Parameters:
- query (string, required): Search terms
- page (number, optional): Page number of results
- perPage (number, optional): Number of results per page

Get Object Details

Name: get-object
Description: Retrieve detailed information about a specific museum object
Parameters:
- id (string, required): Unique identifier of the museum object

Running the Server


node index.js

Development

Ensure all dependencies are installed
Run tests (if applicable)
Check code formatting

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

To-Do’s (Very Much a WIP) ->

Fix image handingling in the artifacts on Claude Desktop

License

Specify your license - e.g., MIT, Apache 2.0

Contact

[]

Acknowledgments

Cooper Hewitt, Smithsonian Design Museum
Model Context Protocol SDK