博物馆藏品API服务

一个用于与Cooper Hewitt博物馆藏品API交互的Model Context Protocol (MCP)服务器,支持编程方式搜索和检索博物馆对象的详细信息。

  • by behole
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 behole/cooper-hewitt-mcp

使用说明

库珀-休伊特模型上下文协议(MCP)服务器

描述

模型上下文协议(MCP)服务器,用于与库伯-休伊特博物馆收藏的API进行交互。该工具允许以编程方式搜索和检索有关博物馆物品的详细信息。

先决条件

  • Node.js(推荐16+版本)
  • npm(节点包管理器)

安装

  1. 克隆存储库:
git clone https://github.com/behole/cooper-hewitt-mcp.git
cd cooper-hewitt-mcp
  1. 安装依赖项:
npm install
  1. 设置API令牌
    • 创建一个 .env 项目根目录中的文件
    • 从获取API令牌 Cooper-Hewitt API
    • 将您的令牌添加到 .env 文件:
    COOPER_HEWITT_API_TOKEN=your_api_token_here
    
  2. 更新您的claude_desktop_config json
"cooper-hewitt": {
      "command": "node",
      "args": ["path to your index.js"]
    }

可用工具

搜索对象

  • 名字: search-objects
  • 描述:搜索库珀·休伊特收藏中的物品
  • 参数:
    • query (字符串,必填):搜索词
    • page (数字,可选):结果页码
    • perPage (数字,可选):每页结果数

获取对象详细信息

  • 名字: get-object
  • 描述:检索特定博物馆对象的详细信息
  • 参数:
    • id (string,必填):博物馆对象的唯一标识符

运行服务器

node index.js

发展

  • 确保安装了所有依赖项
  • 运行测试(如适用)
  • 检查代码格式

贡献

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/AmazingFeature)
  3. 提交您的更改(git commit -m 'Add some AmazingFeature')
  4. 推到分支(git push origin feature/AmazingFeature)
  5. 打开拉取请求

待办事项(非常重要的WIP)->

  • 修复Claude Desktop上工件中的图像处理问题

许可证

指定您的许可证,例如MIT、Apache 2.0

联系

[]

致谢

  • 库珀·休伊特,史密森尼设计博物馆
  • 模型上下文协议SDK