使用说明
哈佛艺术博物馆MCP服务器
一个提供访问权限的模型上下文协议（MCP）服务器 哈佛艺术博物馆API提供超过224,000件艺术品、艺术家记录和博物馆藏品的访问权限。
特点/功能
这个MCP服务器提供了5种工具，用于与哈佛的艺术收藏进行互动：
- 搜索对象 - 使用筛选器在收藏中搜索艺术品
- 获取对象 - 通过ID获取特定艺术品的详细信息
- 搜索人员 - 在收藏中搜索艺术家和人物
- 获取人员信息 - 根据ID获取特定人员的详细信息
- 随机对象 - 获取随机艺术品，并可选择分类/文化过滤器
安装
-
克隆此存储库：
git clone https://github.com/AlexLin1234/harvard-art-museums-mcp-server cd harvard-art-museums -
创建一个虚拟环境并安装依赖项：
python -m venv .venv source .venv/bin/activate # On 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 Desktop（可译为“Claude桌面版”或保持原样，若“Desktop”在此上下文中指明是桌面应用程序或版本，则翻译为“Claude桌面版”更为贴切）
将此配置添加到您的Claude桌面配置文件中：
MacOS/Linux（译文保持原样，因为“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有以下限制：
- 每个API密钥每天2,500次请求
- 请负责任地使用，并在可能的情况下缓存结果
发展
服务器使用：
- MCP SDK（MCP软件开发工具包） 用于模型上下文协议的实现
- 请求： 用于HTTP API调用
- Pydantic（注：这是一个专有名词，通常直接保留原样，不进行翻译，但在此提供其含义以作说明，即“一个用于数据验证和设置管理的Python库”） 用于数据验证
- python-dotenv 用于环境变量管理
许可证
这个项目是开源的，并遵循MIT许可证发布。