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次請求，請合理使用並儘可能緩存結果。