星战科技xingzhan.cloud
返回市场
史密森尼-MCP服务器

史密森尼-MCP服务器

作者：AlexLin12342 星标更新：2025-10-08
安装使用来源：spider==github.com

项目介绍

Smithsonian MCP Server

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

功能

  • 搜索藏品：在来自19个史密森学会博物馆和研究中心的数百万件物品中进行搜索
  • 获取项目详情：检索特定项目的详细元数据
  • 浏览分类：发现可用于细化搜索的术语和过滤器
  • 在线媒体：筛选具有图像和其他在线媒体的项目

安装

先决条件

设置

  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
# 编辑 .env 并添加您的API密钥

或者直接设置环境变量：

export SMITHSONIAN_API_KEY=your_api_key_here

配置Claude Desktop

将以下内容添加到您的Claude Desktop配置文件中：

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"
      }
    }
  }
}

可用工具

search_collection

使用灵活的查询选项搜索史密森学会的藏品。

参数：

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

示例：

搜索带有图片的“航天飞机”项目

get_item

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

参数：

  • item_id（必需）：史密森学会项目ID（从搜索结果中获得）

示例：

获取项目“edanmdm-NASM_A19600093000”的详细信息

get_category_terms

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

参数：

  • category（必需）：类别名称（例如，'online_media_type'，'data_source'，'topic'，'place'）
  • starts_with（可选）：筛选以该字符串开头的术语

示例：

获取以“艺术”开头的主题

示例用法

一旦在Claude Desktop中配置好，您就可以向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文件了解详情

贡献

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

支持

对于相关问题：