Smithsonian MCP Server

史密森尼博物馆MCP服务器

一个模型上下文协议（MCP）服务器，提供访问史密森尼学会开放访问API的权限。搜索并探索史密森尼收藏中的数百万件物品，包括文物、艺术品、标本、照片等。

特点/功能

• 搜索收藏集搜索来自19个史密森尼博物馆和研究中心的数百万件藏品
• 获取物品详情检索特定项目的全面元数据
• 浏览分类发现可用的搜索条件和过滤器以优化搜索
• 网络媒体过滤包含图片和其他在线媒体的项目

安装

先决条件

• Python 3.10 或更高版本
• 一个史密森尼API密钥（免费）- 访问https://api.data.gov/signup/获取一个

设置

1. 克隆仓库：

git clone https://github.com/AlexLin1234/smithsonian-mcp-server.git
cd smithsonian-mcp-server

1. 安装该软件包：

pip install -e .

1. 设置您的API密钥：

cp .env.example .env
# Edit .env and add your API key

或者直接设置环境变量：

export SMITHSONIAN_API_KEY=your_api_key_here

Claude Desktop 的配置

将此添加到您的Claude桌面配置文件中：

MacOS（注：通常直接称为“Mac 操作系统”或简称为“Mac”，但在此按照原文格式翻译为“MacOS”）

位置： ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

位置： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "smithsonian": {
      "command": "python",
      "args": [
        "-m",
        "smithsonian_mcp_server.server"
      ],
      "env": {
        "SMITHSONIAN_API_KEY": "api-key-here"
      }
    }
  }
}

或者，如果你是在虚拟环境中安装的它：

{
  "mcpServers": {
    "smithsonian": {
      "command": "/path/to/venv/bin/python",
      "args": [
        "-m",
        "smithsonian_mcp_server.server"
      ],
      "env": {
        "SMITHSONIAN_API_KEY": "your_api_key_here"
      }
    }
  }
}

可用工具

搜索集合

使用灵活的查询选项搜索史密森尼收藏。

参数：

• query （必填）：搜索查询字符串（支持关键词、带引号的短语、AND/OR 运算符）
• rows （可选）：要返回的结果数量（默认：10，最大：1000）
• start （可选）：分页的起始偏移量（默认：0）
• online_media_only （可选）：仅返回包含在线媒体/图片的项目（默认：false）

示例：

Search for "space shuttle" items with images

获取项目/获取物品

获取特定项目的详细信息。

参数：

• item_id （必填）：史密森尼物品ID（从搜索结果中获取）

示例：

Get details for item "edanmdm-NASM_A19600093000"

获取分类术语

获取特定类别或维度的可用术语。

参数：

• category （必填）：类别名称（例如，“在线媒体类型”、“数据来源”、“主题”、“地点”）
• starts_with （可选）：过滤以该字符串开头的术语

示例：

Get available topics starting with "Art"

示例用法

一旦在Claude桌面版中进行配置，您就可以向Claude提出问题，例如：

• “在史密森尼学会搜索有关莱特兄弟的信息”
• “查找带有图片的与古埃及相关的物品”
• “给我看看航空航天博物馆的展品”
• “获取商品编号edanmdm-NASM_A19600093000的详细信息”
• “史密森尼API中提供了哪些数据源？”

API 信息

这个服务器使用的是史密森尼开放获取API v1.0：

• 基本URL： https://api.si.edu/openaccess/api/v1.0
• 文档链接：https://www.si.edu/openaccess/devtools
• 收藏集：280多万件开放获取资源
• 覆盖范围：19座史密森尼博物馆、研究中心和图书馆

发展

安装开发依赖项

pip install -e ".[dev]"

运行测试

pytest

代码格式化

black src/
ruff check src/

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件

贡献；助力

欢迎贡献！请随时提交拉取请求。

支持

对于以下相关问题：

• 这个MCP服务器：在GitHub上提交一个问题
• 史密森尼API：访问https://www.si.edu/openaccess/faq
• Claude 桌面版：请访问 https://docs.claude.com