MCP 服务器

Rijksmuseum MCP Server

允许您搜索艺术品、检索有关特定艺术品的详细信息、访问艺术品的图像图块，以及探索来自荷兰国家博物馆的用户创建的藏品。

Tools

get_artwork_image

Retrieve detailed image tile information for high-resolution viewing of an artwork. This tool provides data for implementing deep zoom functionality, allowing detailed examination of the artwork at various zoom levels. The response includes multiple zoom levels (z0 to z6): - z0: Highest resolution (largest image) - z6: Lowest resolution (smallest image) Each zoom level contains: - Total width and height of the image at that level - A set of image tiles that make up the complete image - Position information (x,y) for each tile This is particularly useful for: - Implementing deep zoom viewers - Studying fine artwork details - Analyzing brushwork or conservation details - Creating interactive viewing experiences

get_user_sets

Retrieve collections created by Rijksstudio users. These are curated sets of artworks that users have grouped together based on themes, artists, periods, or personal interests. Each set includes: - Basic information (name, description, creation date) - Creator details (username, language preference) - Collection statistics (number of items) - Navigation links (API and web URLs) This tool is useful for: - Discovering user-curated exhibitions - Finding thematically related artworks - Exploring popular artwork groupings - Studying collection patterns

get_user_set_details

Retrieve detailed information about a specific user-created collection in Rijksstudio. Returns comprehensive information about the set and its contents, including: - Set metadata (name, description, creation date) - Creator information - List of artworks in the set - Image data for each artwork - Navigation links This tool is particularly useful for: - Analyzing thematic groupings of artworks - Studying curatorial choices - Understanding collection patterns - Exploring relationships between artworks

open_image_in_browser

Open a high-resolution image of an artwork in the default web browser for viewing. This tool is useful when you want to examine an artwork visually or show it to the user. Works with any valid Rijksmuseum image URL.

get_artist_timeline

Generate a chronological timeline of an artist's works in the Rijksmuseum collection. This tool is perfect for studying an artist's development, analyzing their artistic periods, or understanding their contribution to art history over time.

search_artwork

Search and filter artworks in the Rijksmuseum collection. This tool provides extensive filtering options including artist name, type of artwork, materials, techniques, time periods, colors, and more. Results can be sorted in various ways and are paginated.

get_artwork_details

Retrieve comprehensive details about a specific artwork from the Rijksmuseum collection. Returns extensive information including: - Basic details (title, artist, dates) - Physical properties (dimensions, materials, techniques) - Historical context (dating, historical persons, documentation) - Visual information (colors, image data) - Curatorial information (descriptions, labels, location) - Acquisition details - Exhibition history This is the primary tool for in-depth research on a specific artwork, providing all available museum documentation and metadata.

README

阿姆斯特丹国立博物馆 MCP 服务器

一个模型上下文协议 (MCP) 服务器，通过自然语言交互提供对阿姆斯特丹国立博物馆藏品的访问。该服务器使 AI 模型能够探索、分析和与阿姆斯特丹国立博物馆的艺术品和藏品进行交互。

特性

该服务器提供了几个与阿姆斯特丹国立博物馆藏品交互的工具：

1. 搜索艺术品 (`search_artwork`)

使用各种标准搜索和过滤艺术品，包括：

基于文本的搜索
艺术家姓名
艺术品类型
材料和技术
时间段
颜色
以及更多

2. 艺术品详情 (`get_artwork_details`)

检索有关特定艺术品的全面信息，包括：

基本详情（标题、艺术家、日期）
物理属性
历史背景
视觉信息
策展信息
展览历史

3. 高分辨率图像 (`get_artwork_image`)

访问具有深度缩放功能的高分辨率图像数据：

多个缩放级别
基于瓦片的图像加载
完全分辨率支持
位置信息

4. 用户收藏集 (`get_user_sets` & `get_user_set_details`)

探索用户创建的收藏集：

浏览精选集
查看主题分组
分析收藏模式
访问详细的集合信息

5. 图像查看 (`open_image_in_browser`)

直接在浏览器中打开艺术品图像以进行详细查看。

6. 艺术家时间线 (`get_artist_timeline`)

生成艺术家作品的按时间顺序排列的时间线：

跟踪艺术发展
分析时期和风格
研究职业发展

示例用例

以下是一些您在使用此服务器时可以向 AI 提出的示例查询：

艺术品发现

"展示伦勃朗 17 世纪 40 年代的所有画作"
"查找以蓝色为主的艺术品"
"馆藏中最著名的杰作是什么？"
"搜索荷兰黄金时代的静物画"

艺术品分析

"告诉我关于《夜巡》的一切"
"梵高的《自画像》的尺寸和材料是什么？"
"展示维米尔的《倒牛奶的女仆》中笔触的高分辨率细节"
"比较《吃土豆的人》不同版本中使用的颜色"

艺术家研究

"创建伦勃朗自画像的时间线"
"梵高在其职业生涯中如何演变对颜色的使用？"
"按时间顺序显示弗兰斯·哈尔斯的所有作品"
"扬·斯蒂恩在他的画作中使用了哪些技巧？"

主题探索

"查找所有描绘圣经场景的艺术品"
"展示 17 世纪阿姆斯特丹的画作"
"哪些艺术品以花卉或静物布置为特色？"
"查找包含乐器的肖像"

收藏分析

"展示最受欢迎的用户策划的收藏集"
"查找专注于风景画的集合"
"博物馆最近添加了哪些藏品？"
"展示包含多位艺术家作品的收藏集"

视觉细节

"让我检查《夜巡》背景中的细节"
"展示《戴珍珠耳环的少女》中珠宝的特写"
"你能展示最高分辨率版本的《犹太新娘》吗？"
"我想研究《辛迪克》中的面部表情"

开始使用

您可以通过两种方式安装此服务器：

1. 使用带有 NPM 包的 Claude Desktop

更新您的 Claude 配置文件 (~/Library/Application Support/Claude/claude_desktop_config.json)：

{
  "mcpServers": {
    "rijksmuseum-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-rijksmuseum"
      ],
      "env": {
        "RIJKSMUSEUM_API_KEY": "your_api_key_here"
      }
    }
  }
}

您可以从阿姆斯特丹国立博物馆 API 门户获取 API 密钥。

2. 从源代码

克隆此存储库
安装依赖项：
```
npm install
```
复制示例环境变量文件：
```
cp .env.example .env
```
将您的阿姆斯特丹国立博物馆 API 密钥添加到 .env 文件：
```
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 部分添加您的阿姆斯特丹国立博物馆 API 密钥

更新配置后，重新启动 Claude Desktop 以使更改生效。

配置

可以通过环境变量配置服务器：

RIJKSMUSEUM_API_KEY: 您的阿姆斯特丹国立博物馆 API 密钥（必需）
PORT: 服务器端口（默认：3000）
LOG_LEVEL: 日志记录级别（默认：'info'）

API 文档

有关此服务器使用的阿姆斯特丹国立博物馆 API 端点的详细信息，请访问：阿姆斯特丹国立博物馆 API 文档

贡献

欢迎贡献！请随时提交拉取请求或创建问题以报告错误和提出功能请求。

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。