rijksmuseum-mcp 是一个 Model Context Protocol（MCP）服务器，通过自然语言交互提供对荷兰国家博物馆（Rijksmuseum）馆藏的访问能力。该服务器使 AI 模型能够探索、分析并与 Rijksmuseum 的艺术品和收藏进行交互。
用途 面向希望借助 AI 模型检索与分析 Rijksmuseum 馆藏的用户，通过 MCP 协议将博物馆 API 的能力接入 AI 对话环境，实现自然语言驱动的艺术品搜索、详情查询与收藏浏览。
主要能力 服务器提供以下工具：
- 搜索艺术品（search_artwork）：支持基于文本、材料与技法等多种条件搜索和筛选艺术品。
- 艺术品详情（get_artwork_details）：检索特定艺术品的综合信息，包括基本信息（标题、艺术家、日期）、物理属性、历史背景、视觉信息、策展信息、展览历史。
- 高清图像（get_artwork_image）：获取高清图像数据并支持深度缩放，包含多缩放级别、基于切片的图像加载、全分辨率支持与位置信息。
- 用户收藏（get_user_sets 与 get_user_set_details）：探索用户创建的收藏，包括浏览策展集合、查看主题分组、分析收藏模式、访问集合详细信息。
- 图像查看（open_image_in_browser）：直接在浏览器中打开艺术品图像以便细致查看。
- 艺术家时间线（get_artist_timeline）：生成艺术家作品的编年时间线，用于追踪艺术发展、分析时期与风格、研究职业进程。
使用方式 可通过两种方式安装该服务器： 方式一：使用 Claude Desktop 配合 NPM 包。需更新 Claude 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）。API 密钥可从 Rijksmuseum API Portal 获取。 方式二：克隆本仓库，安装依赖：npm install，复制示例环境文件：cp .env.example .env，在 .env 文件中加入 Rijksmuseum API 密钥：RIJKSMUSEUM_API_KEY=your_api_key_here，然后更新 Claude 配置文件：{ "mcpServers" : { "rijksmuseum-server" : { "command" : " node " , "args" : [ " /path/to/rijksmuseum-server/build/index.js " ] , "env" : { "RIJKSMUSEUM_API_KEY" : " your_api_key_here " } } } }，将 /path/to/rijksmuseum-server 替换为实际安装路径，并在 env 部分填入 Rijksmuseum API 密钥。更新配置后，重启 Claude Desktop 使更改生效。
服务器可通过环境变量进行配置： RIJKSMUSEUM_API_KEY：Rijksmuseum API 密钥（必需） PORT：服务器端口（默认：3000） LOG_LEVEL：日志级别（默认：'info'）
适用场景 示例用例涵盖艺术品发现、艺术品分析、艺术家研究、主题探索与收藏分析等自然语言查询场景。
限制 使用需要 Rijksmuseum API 密钥。详细的 Rijksmuseum API 端点信息可参阅 Rijksmuseum API Documentation。项目欢迎贡献，可提交拉取请求或创建 issue 报告缺陷与功能请求。本项目采用 MIT 许可证，详见 LICENSE 文件。
