What is Cooper Hewitt Mcp

The cooper-hewitt-mcp is a Model Context Protocol (MCP) server designed for interacting with the Cooper Hewitt Museum’s collection API, enabling programmatic access to detailed information about museum objects.

Use cases

Use cases include developing educational tools that provide access to museum collections, creating applications for researchers to explore museum data, and integrating museum information into digital platforms or exhibitions.

How to use

To use cooper-hewitt-mcp, clone the repository, install the necessary dependencies, set up an API token in a .env file, and run the server using Node.js. You can then utilize the available tools to search for objects or retrieve details about specific museum items.

Key features

Key features include the ability to search for objects in the Cooper Hewitt collection using various parameters, and to retrieve detailed information about specific objects using their unique identifiers.

Where to use

cooper-hewitt-mcp can be used in fields such as museum studies, digital humanities, and software development, particularly in applications that require access to museum collections and their data.

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

1. Clone the repository:

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

2. Install dependencies:

npm install

3. 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
   

4. 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

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. 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