Cooper Hewitt MCP Server 使用说明

项目简介

Cooper Hewitt MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它为大型语言模型 (LLM) 客户端提供访问史密森尼设计博物馆馆藏数据的能力。通过此服务器，LLM 可以使用预定义的工具来搜索馆藏对象、获取详细信息，从而扩展 LLM 在艺术和设计领域的知识和应用范围。

主要功能点

搜索馆藏对象 (search-objects): 允许用户通过关键词查询 Cooper Hewitt 博物馆的馆藏品，并返回包含对象基本信息的列表。
获取对象详情 (get-object): 允许用户通过对象ID获取特定馆藏品的详细信息，包括描述、尺寸、图片等。

安装步骤

克隆仓库:

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

安装依赖:
```
npm install
```
配置 API Token:
- 在项目根目录下创建 '.env' 文件。
- 访问 Cooper Hewitt API 网站获取 API 密钥。
- 将 API 密钥添加到 '.env' 文件中，例如：
```
COOPER_HEWITT_API_TOKEN=your_api_token_here
```

服务器配置

对于 MCP 客户端（例如 Claude），您需要配置服务器的启动命令。以下是一个示例 'claude_desktop_config.json' 配置，用于连接 Cooper Hewitt MCP Server：

{
  "servers": {
    "cooper-hewitt": {
      "command": "node",
      "args": ["/path/to/cooper-hewitt-mcp/build/index.js"]
    }
  }
}

配置参数说明:

server name: 'cooper-hewitt' - 服务器名称，客户端通过此名称识别和调用该服务器。
command: 'node' - 启动服务器的命令，这里使用 Node.js 运行时环境。
args: '["/path/to/cooper-hewitt-mcp/build/index.js"]' - 传递给 'command' 的参数，指向服务器入口文件 'index.js' 的路径。请将 '/path/to/cooper-hewitt-mcp' 替换为您实际的仓库路径。

注意: 确保您已安装 Node.js 环境，并将 'node' 命令添加到系统环境变量中。

基本使用方法

确保已按照安装步骤完成配置并启动 Cooper Hewitt MCP Server ('node build/index.js')。
在 MCP 客户端中配置并连接到 'cooper-hewitt' 服务器。
在客户端中，您可以使用以下工具与 Cooper Hewitt 博物馆馆藏进行交互：
- 搜索馆藏对象: 调用 'search-objects' 工具，并提供 'query' 参数进行搜索，例如 'query: "chairs"'。可以选择性地添加 'page' 和 'perPage' 参数来控制分页。
- 获取对象详情: 调用 'get-object' 工具，并提供 'id' 参数 (馆藏对象的唯一标识符) 来获取详细信息，例如 'id: "18693327"'。

通过这些工具，LLM 客户端可以方便地访问和利用 Cooper Hewitt 博物馆的馆藏数据，从而实现更丰富的应用场景。

关键词