项目简介

Smithsonian开放访问MCP服务器（Smithsonian Open Access MCP Server）是一个基于Model Context Protocol (MCP) 标准构建的应用后端。它允许大型语言模型（LLM）客户端（如Claude Desktop）以结构化的方式访问和利用史密森尼学会超过300万件开放访问藏品的丰富数据。服务器通过提供一系列工具和预定义提示，简化了AI对博物馆藏品的搜索、探索和分析过程。

主要功能点

全面搜索藏品: 能够搜索史密森尼学会19个博物馆的300多万件藏品，支持多种过滤条件，如博物馆、物品类型、创作者、材料、主题等。
获取对象详情: 提供藏品的完整元数据、描述、高分辨率图片、3D模型链接等详细信息。
展览状态查询: 查找当前正在实体展出的藏品，或检查特定藏品的展览状态。
智能探索与分页: 提供多样化、避免重复的智能探索功能，并支持多页查询，确保即使在大量结果中也能找到特定物品。
上下文数据提供: 能够以结构化的文本形式为AI助手提供搜索结果、对象详情、博物馆列表和统计数据，作为其理解和推理的上下文信息。
Prompt模板: 内置多种可定制的Prompt模板，用于指导AI进行藏品研究、对象分析、展览规划和教育内容创建等复杂任务。

安装步骤

该服务器推荐使用 'npm/npx' (需要Node.js和Python 3.10+，自动管理Python依赖) 或 Python 进行安装。

获取API密钥: 访问 'api.data.gov/signup' 免费注册并获取API密钥。
设置API密钥: 将获取到的API密钥设置为环境变量 'SMITHSONIAN_API_KEY'。例如：'export SMITHSONIAN_API_KEY=your_key_here' (macOS/Linux) 或在 '.env' 文件中添加 'SMITHSONIAN_API_KEY=your_key_here'。
安装并运行 (推荐使用 npm/npx):
- 全局安装：'npm install -g @molanojustin/smithsonian-mcp'
- 或直接运行：'npx -y @molanojustin/smithsonian-mcp'
安装并运行 (Python 用户):
- 安装依赖：'uv pip install -r config/requirements.txt'
- 启动服务器：'python -m smithsonian_mcp.server'

服务器配置 (MCP客户端使用)

MCP客户端需要MCP服务器的启动命令。以下是为 'smithsonian_open_access' 服务器提供的典型JSON配置信息，通常会放置在MCP客户端的配置文件中 (例如 'claude_desktop_config.json')。

{
  "mcpServers": {
    "smithsonian_open_access": {
      "command": "npx",
      "args": ["-y", "@molanojustin/smithsonian-mcp"],
      "env": {
        "SMITHSONIAN_API_KEY": "your_api_key_here"
      }
    }
  }
}

'"command"': 指定用于启动MCP服务器的可执行命令，这里是 'npx'，因为它提供了跨平台的便利性。
'"args"': 传递给 'command' 的参数列表。'["-y", "@molanojustin/smithsonian-mcp"]' 表示使用 'npx' 运行 '@molanojustin/smithsonian-mcp' 包。
'"env"': MCP服务器运行所需的环境变量。'"SMITHSONIAN_API_KEY": "your_api_key_here"' 需替换为您的实际API密钥。

基本使用方法

在MCP服务器启动并被MCP客户端（如Claude Desktop）正确配置后，您可以通过向AI助手提问来使用其功能。例如：

询问史密森尼学会可用的博物馆列表："What Smithsonian museums are available?"
搜索特定主题的藏品："Find some objects related to dinosaurs."
获取特定藏品的详细信息（通过其ID）：“Tell me more about object with ID: NMAAHC_2008.24.1”
查询正在展出的艺术品：“What art is currently on display at the Smithsonian American Art Museum?”

关键词

项目简介

主要功能点

安装步骤

服务器配置 (MCP客户端使用)

基本使用方法

信息