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.

Related MCP server: MCP-OpenAPI

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