JinDaGe - harvard-art-museums-mcp-server MCP Details

article

README

🚀 哈佛艺术博物馆MCP服务器

这是一个模型上下文协议（MCP）服务器，可用于访问哈佛艺术博物馆API，该API提供超过224,000件艺术品、艺术家记录和博物馆藏品的信息。

✨ 主要特性

此MCP服务器提供了5种与哈佛艺术藏品进行交互的工具：

search_objects - 使用过滤器搜索藏品中的艺术品
get_object - 通过ID获取特定艺术品的详细信息
search_people - 搜索藏品中的艺术家和人物
get_person - 通过ID获取特定人物的详细信息
random_object - 获取一件随机的艺术品，可选择添加分类或文化过滤器

📦 安装指南

克隆此仓库：

git clone https://github.com/AlexLin1234/harvard-art-museums-mcp-server
cd harvard-art-museums

创建虚拟环境并安装依赖：

python -m venv .venv
source .venv/bin/activate  # 在Windows上使用：.venv\Scripts\activate
pip install mcp requests python-dotenv pydantic

从https://harvardartmuseums.org/collections/api 获取免费的API密钥。
在项目根目录下创建一个 .env 文件：

HARVARD_ART_MUSEUMS_API_KEY=your_api_key_here

📚 详细文档

Claude桌面端

将以下配置添加到你的Claude桌面端配置文件中：

MacOS/Linux：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "harvard-art-museums": {
      "command": "python",
      "args": ["/absolute/path/to/harvard-art-museums/server.py"],
      "env": {
        "HARVARD_ART_MUSEUMS_API_KEY": "your_api_key_here"
      }
    }
  }
}

⚠️ 重要提示

请确保使用 server.py 的绝对路径，并在需要时包含虚拟环境的Python解释器：

Windows："C:\\Users\\YourName\\path\\to\\harvard-art-museums\\.venv\\Scripts\\python.exe"

MacOS/Linux："/Users/YourName/path/to/harvard-art-museums/.venv/bin/python"

其他MCP客户端

对于其他支持MCP的客户端，可按以下方式配置服务器：

命令：Python可执行文件的路径（建议使用虚拟环境中的Python）
参数：server.py 的路径
环境变量：将 HARVARD_ART_MUSEUMS_API_KEY 设置为你的API密钥

💻 使用示例

连接到Claude桌面端后，你可以提出以下问题：

"搜索莫奈的印象派画作"
"给我找一件随机的日本艺术品"
"告诉我关于巴勃罗·毕加索的信息"
"展示ID为299843的藏品的详细信息"

🔧 技术细节

该服务器使用了以下技术：

MCP SDK：用于实现模型上下文协议
Requests：用于进行HTTP API调用
Pydantic：用于数据验证
python-dotenv：用于管理环境变量

📄 许可证

本项目是开源的，采用MIT许可证。

📚 相关资源

⚠️ 重要提示

哈佛艺术博物馆API有以下限制：每个API密钥每天最多可进行2500次请求，请合理使用并尽可能缓存结果。

harvard-art-museums-mcp-server