返回 MCP 目录
public公开dns本地运行

Cooper Hewitt

一个用于与Cooper Hewitt博物馆藏品API交互的MCP服务器工具,支持搜索和获取博物馆物品的详细信息。

article

README

🚀 协作 Hewitt 模型上下文协议(MCP)服务器

本项目是一个用于与合作惠特博物馆收藏 API 进行交互的模型上下文协议(MCP)服务器。借助该工具,用户能够搜索并以程序化的方式检索有关博物馆藏品的详细信息。

🚀 快速开始

运行服务器

在完成后续安装步骤后,可使用以下命令启动服务器:

node index.js

✨ 主要特性

  • 提供了强大的搜索功能,可在 Cooper Hewitt 藏品中搜索对象。
  • 支持检索特定博物馆藏品的详细信息。

📦 安装指南

先决条件

  • Node.js(建议版本 16+)
  • npm(Node 包管理器)

安装步骤

  1. 克隆仓库
git clone https://github.com/behole/cooper-hewitt-mcp.git
cd cooper-hewitt-mcp
  1. 安装依赖项
npm install
  1. 设置 API 令牌

    • 在项目根目录中创建一个 .env 文件。
    • Cooper Hewitt API 获取 API 令牌。
    • 将您的令牌添加到 .env 文件中:
    COOPER_HEWITT_API_TOKEN=your_api_token_here
    
  2. 更新您的 claude_desktop_config.json

"cooper-hewitt": {
      "command": "node",
      "args": ["您 index.js 的路径"]
    }

💻 使用示例

搜索对象

  • 名称search-objects
  • 描述:在 Cooper Hewitt 藏品中搜索对象
  • 参数
    • query(字符串,必需):搜索词
    • page(数字,可选):结果页码
    • perPage(数字,可选):每页结果数量

获取对象详细信息

  • 名称get-object
  • 描述:检索特定博物馆藏品的详细信息
  • 参数
    • id(字符串,必需):藏品唯一标识符

📚 详细文档

开发

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

贡献

  1. 叉克隆仓库。
  2. 创建功能分支 (git checkout -b feature/AmazingFeature)。
  3. 提交更改 (git commit -m 'Add some AmazingFeature')。
  4. 推送到分支 (git push origin feature/AmazingFeature)。
  5. 打开 Pull Request。

待办事项(非常初期的工作)

  • 修复 Claude 桌面中的图像处理问题。

📄 许可证

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

联系方式

[]

致谢

  • 协作惠特,史密森尼设计博物馆
  • 模型上下文协议 SDK
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端