Harvard Art Museums MCP Server

🚀 ハーバード美術館MCPサーバー

このモデルコンテキストプロトコル（MCP）サーバーは、ハーバード美術館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 Desktop

Claude Desktopの設定ファイルに以下の設定を追加します。

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実行ファイルのパス（できれば仮想環境のもの）
• 引数: server.pyのパス
• 環境: HARVARD_ART_MUSEUMS_API_KEYをあなたのAPIキーに設定します。

💻 使用例

Claude Desktopに接続したら、以下のような質問をすることができます。

• "モネの印象派の絵を検索して"
• "ランダムな日本の美術作品を見つけて"
• "パブロ・ピカソについて教えて"
• "オブジェクトID 299843の詳細を見せて"

🔧 技術詳細

ハーバード美術館APIには以下の制限があります。

• APIキーごとに1日2,500リクエスト
• 責任を持って使用し、可能な場合は結果をキャッシュしてください。

開発

このサーバーは以下を使用しています。

• MCP SDK - モデルコンテキストプロトコルの実装
• Requests - HTTP API呼び出し
• Pydantic - データ検証
• python-dotenv - 環境変数管理

📄 ライセンス

このプロジェクトはオープンソースで、MITライセンスの下で利用可能です。

📚 リソース

• ハーバード美術館APIドキュメント
• モデルコンテキストプロトコルドキュメント
• MCP Python SDK