Harvard Art Museums MCP Server

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

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

✨ 主要特性

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

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

📦 安装指南

1. 克隆此仓库：

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

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

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

3. 从https://harvardartmuseums.org/collections/api 获取免费的API密钥。

4. 在项目根目录下创建一个 .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文档
• 模型上下文协议文档
• MCP Python SDK

⚠️ 重要提示

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