cooper-hewitt-mcp
by behole
Verified
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:
Copy
git clone https://github.com/behole/cooper-hewitt-mcp.git
cd cooper-hewitt-mcp
- Install dependencies:
Copy
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:
CopyCOOPER_HEWITT_API_TOKEN=your_api_token_here - Create a
- Update your claude_desktop_config.json
Copy
"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 termspage
(number, optional): Page number of resultsperPage
(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
Copy
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