Rijksmuseum MCP 服务器使用说明

项目简介

Rijksmuseum MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型 (LLM) 提供访问阿姆斯特丹国立博物馆 (Rijksmuseum) 艺术品收藏数据的能力。通过此服务器，LLM 可以通过自然语言交互，探索、分析和互动博物馆的艺术品和藏品。

主要功能点

艺术品检索 (search_artwork): 根据关键词、艺术家、艺术品类型、材质、技法、时期、颜色等多种条件检索 Rijksmuseum 的艺术品。
艺术品详情 (get_artwork_details): 获取特定艺术品的全面信息，包括基本信息、物理属性、历史背景、图像信息和策展信息等。
高分辨率图像 (get_artwork_image): 访问艺术品的高分辨率图像数据，支持深度缩放，方便细节观察。
用户收藏 (get_user_sets & get_user_set_details): 浏览和分析 Rijksmuseum 用户创建的艺术品收藏集，了解主题分组和收藏模式。
浏览器打开图像 (open_image_in_browser): 直接在浏览器中打开艺术品图像，方便用户查看。
艺术家时间线 (get_artist_timeline): 生成艺术家作品的时间线，跟踪艺术发展历程。

安装步骤

本服务器提供两种安装方式：

1. 使用 Claude Desktop 通过 NPM 包安装 (推荐)

这种方式最简便，前提是你使用 Claude Desktop 并且配置了 MCP 服务器功能。

a. 获取 Rijksmuseum API 密钥: 访问 Rijksmuseum API Portal 注册并获取 API 密钥 (RIJKSMUSEUM_API_KEY)。

b. 修改 Claude 配置文件: 打开 Claude Desktop 的配置文件 '~/Library/Application Support/Claude/claude_desktop_config.json' (路径可能因操作系统而异)。

c. 添加服务器配置: 在 'mcpServers' 字段下添加 'rijksmuseum-server' 的配置信息，将 'your_api_key_here' 替换为你获取的 API 密钥。

{
  "mcpServers": {
    "rijksmuseum-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-rijksmuseum"
      ],
      "env": {
        "RIJKSMUSEUM_API_KEY": "your_api_key_here"  // 替换为你的 API 密钥
      }
    }
  }
}

2. 从源代码安装

这种方式较为复杂，但可以自定义服务器配置。

a. 克隆仓库: 使用 Git 克隆 Rijksmuseum MCP Server 仓库到本地。

bash       git clone https://github.com/r-huijts/rijksmuseum-mcp.git       cd rijksmuseum-mcp

b. 安装依赖: 使用 npm 安装项目依赖。

bash       npm install

c. 配置环境变量: 复制示例环境变量文件并修改 '.env' 文件，将 'your_api_key_here' 替换为你获取的 API 密钥。

bash       cp .env.example .env

编辑 '.env' 文件:

      RIJKSMUSEUM_API_KEY=your_api_key_here  # 替换为你的 API 密钥

d. 修改 Claude 配置文件: 打开 Claude Desktop 的配置文件 '~/Library/Application Support/Claude/claude_desktop_config.json' (路径可能因操作系统而异)。

e. 添加服务器配置: 在 'mcpServers' 字段下添加 'rijksmuseum-server' 的配置信息，将 '/path/to/rijksmuseum-server/build/index.js' 替换为你的本地仓库 'build/index.js' 文件的绝对路径，并将 'your_api_key_here' 替换为你获取的 API 密钥。

{
  "mcpServers": {
    "rijksmuseum-server": {
      "command": "node",
      "args": [
        "/path/to/rijksmuseum-server/build/index.js" // 替换为你的 build/index.js 文件的绝对路径
      ],
      "env": {
        "RIJKSMUSEUM_API_KEY": "your_api_key_here"  // 替换为你的 API 密钥
      }
    }
  }
}

  **注意:**  '/path/to/rijksmuseum-server' 需要替换为实际的本地仓库路径，例如 '/Users/yourusername/Documents/rijksmuseum-mcp'。 使用绝对路径非常重要。

f. 重启 Claude Desktop: 完成配置后，重启 Claude Desktop 使配置生效。

服务器配置 (MCP 客户端配置)

以下是在 MCP 客户端 (如 Claude Desktop) 中配置 Rijksmuseum MCP 服务器的 JSON 格式配置信息。客户端需要根据这些信息启动和连接服务器。

使用 NPM 包安装的配置:

{
  "mcpServers": {
    "rijksmuseum-server": {  // 服务器名称，客户端用于标识
      "command": "npx",      // 启动服务器的命令，这里使用 npx 运行 npm 包
      "args": [              // 命令参数
        "-y",                 // npx 参数，自动确认安装包
        "mcp-server-rijksmuseum" // 要运行的 npm 包名称
      ],
      "env": {                // 环境变量
        "RIJKSMUSEUM_API_KEY": "your_api_key_here" // 传递 Rijksmuseum API 密钥
      }
    }
  }
}

从源代码安装的配置:

{
  "mcpServers": {
    "rijksmuseum-server": {  // 服务器名称，客户端用于标识
      "command": "node",     // 启动服务器的命令，这里使用 node 运行 JavaScript 文件
      "args": [              // 命令参数
        "/path/to/rijksmuseum-server/build/index.js" // 服务器入口文件 build/index.js 的绝对路径
      ],
      "env": {                // 环境变量
        "RIJKSMUSEUM_API_KEY": "your_api_key_here"  // 传递 Rijksmuseum API 密钥
      }
    }
  }
}

基本使用方法

启动 MCP 客户端: 启动配置了 Rijksmuseum MCP 服务器的 MCP 客户端 (如 Claude Desktop)。
在客户端中使用自然语言查询: 在客户端的对话界面中使用自然语言提问，例如：
- "搜索伦勃朗在 1640 年代创作的所有画作"
- "告诉我关于《夜巡》的一切"
- "展示梵高自画像的高分辨率细节"
- "打开《戴珍珠耳环的少女》的图像"
- "创建伦勃朗自画像的时间线"
客户端会将这些自然语言查询转换为对 Rijksmuseum MCP 服务器的 MCP 请求，服务器会调用相应的工具并返回结果。

注意: 首次使用可能需要 Claude Desktop 下载和安装 'mcp-server-rijksmuseum' NPM 包 (如果使用 NPM 包安装方式)。

关键词