Met Museum MCP Server


大都会博物馆MCP服务器

一种模型上下文协议（MCP）服务器，通过自然语言交互提供对大都会艺术博物馆收藏的访问。该服务器允许人工智能模型搜索大都会博物馆的艺术品收藏，并通过工具结果检索艺术品细节（包括图像）。

](https://mseep.ai/app/mikechao-metmuseum-mcp)


目录

• 特性

- 列出部门 - 搜索博物馆物品 - 获取博物馆物品 - 打开Met Explorer应用程序

• MCP应用程序
• 先决条件
• 快速开始
• 配置
• 运输

- 可流式HTTP传输

• 使用ChatGPT
• 使用Claude Desktop
• 使用LibreChat
• 示例查询
• 发展
• 贡献
• 许可证
• 免责声明

托管部署

托管部署可在 Frontier AI.

特性

该服务器为人工智能模型提供了以下工具，用于与大都会博物馆的艺术收藏进行交互：

1.列出部门（列出部门）

列出大都会艺术博物馆的所有有效部门

• 输入：

- 无

• 输出：

  Department ID: 1, Display Name: American Decorative Arts
  Department ID: 3, Display Name: Ancient Near Eastern Art
  ...

2.搜索博物馆物品（搜索博物馆物品）

根据输入在The Met中搜索各种对象。

• 输入：

- q （string）：搜索词，例如向日葵 - hasImages （boolean，可选，默认值：false）：仅搜索带有图像的对象 - title （boolean，可选，默认值：false）：返回与查询匹配的对象，特别是在标题字段中搜索对象。 - departmentId （number，可选）：返回属于特定部门的对象。 - page （number，可选，默认值：1）：结果的页码从1开始。 - pageSize （数字，可选，默认值：24）：每页对象ID的数量（最多100个）。

• 输出：

  Total objects found: 54
  Page: 1/3
  Object IDs: 436532, 789578, 436840, 438722,...

3.获取博物馆物品（获取博物馆物品）

从The Met获取一个特定对象，其中包含有关该对象的所有开放访问数据，包括其图像（如果图像在开放访问下可用）。

如果有图像和 returnImage 如果为true，它将作为工具结果中的图像内容块（base64编码的JPEG）返回。

当用户询问特定艺术品的更深入细节，而你已经有了 objectId.

• 输入：

- objectId （number）：要检索的对象的id - returnImage （boolean，可选，默认值：true）：是否在工具结果中包含对象的图像（如果可用）

• 输出：

  Title: Self-Portrait with a Straw Hat (obverse: The Potato Peeler)
  Artist: Vincent van Gogh
  Artist Bio: Dutch, Zundert 1853–1890 Auvers-sur-Oise
  Department: European Paintings
  Credit Line: Bequest of Miss Adelaide Milton de Groot (1876-1967), 1967
  Medium: Oil on canvas
  Dimensions: 16 x 12 1/2 in. (40.6 x 31.8 cm)
  Primary Image URL: https://images.metmuseum.org/CRDImages/ep/original/DT1502_cropped2.jpg
  Tags: Men, Self-portraits

如果returnImage为true

  **base64 encoding of jpeg image**

4. 使用浏览器应用程序打开 （使用浏览器打开）

推出交互式MCP应用程序(ui://met/explorer.html)它可以从支持应用程序的MCP客户端中搜索、过滤和检查对象。

推荐流量：

• 使用 open-met-explorer 启动并浏览实时搜索结果（pass q 立即开始搜索）。

• 根据当前结果创建策划列表后，使用 get-museum-object 仅适用于用户想要深入探索的项目。

• 输入（全部可选）：

- q （string）：初始搜索词。 - hasImages （boolean，默认值：true）：首选带有图像的对象。 - title （布尔值，默认值：false）：仅搜索标题。 - departmentId （数字）：预选部门筛选器。

• 输出：

  Opens the Met Explorer app in the client UI.

MCP应用程序

▶️ Click to watch the demo video

现在有 MCP应用程序 在这个MCP服务器中。有一个UI组件 打开Met Explorer应用程序 工具和 获取博物馆物品 工具。

先决条件

• v18或更高版本

快速开始

直接使用以下命令运行服务器 npx --无需安装：

npx -y metmuseum-mcp

这将使用以下命令启动服务器 stdio传输，这是大多数MCP桌面客户端所期望的。

有关特定于客户端的设置，请参阅：

• 使用Claude Desktop
• 使用ChatGPT （要求 可流式HTTP传输)
• 使用LibreChat

配置

以下环境变量适用于 所有运输工具:

运输

此服务器支持两种传输方式：

• 标准传输（默认）： MCP桌面客户端（Claude desktop、LibreChat MCP等）使用。
• 可流式HTTP传输： 与一起跑步 --http 在以下位置暴露MCP端点 /mcp.

可流式HTTP传输

与一起跑步 npx （推荐给终端用户）：

npx -y metmuseum-mcp --http

或者从本地克隆运行：

pnpm run build
node dist/index.js --http

服务器监听：

http://localhost:3001/mcp

您可以使用环境变量控制HTTP服务器行为：

例子：

HOST=127.0.0.1 PORT=8080 ALLOWED_HOSTS=localhost,127.0.0.1 npx -y metmuseum-mcp --http

使用ChatGPT

以下步骤允许您将大都会博物馆MCP与ChatGPT的web UI一起使用

1.在ChatGPT中启用开发人员模式

设置→ Apps → 高级设置→ 开发者模式

附加说明 这里

2.使用流式HTTP传输运行大都会博物馆MCP服务器

npx -y metmuseum-mcp --http

默认情况下，服务器将侦听 http://127.0.0.1:3001/mcp

3.创建本地隧道，将MCP服务器暴露给ChatGPT

注册并配置 吸烟，免费计划有效。

ngrok http http://127.0.0.1:3001 --host-header=rewrite

记下转发URL。

...
Forwarding                    https://john-joe-asdf.ngrok-free.dev -> http://localhost:3001
...

4.将Met Museum MCP添加为ChatGPT的连接器

打开 ChatGPT应用程序设置

单击应用程序

单击“创建应用程序”

使用步骤3中的URL作为MCP服务器URL填写表格，但添加 /mcp.

https://john-joe-asdf.ngrok-free.dev/mcp

对于身份验证，选择“无身份验证”

勾选“我理解并想继续”复选框

然后单击“创建”。

5.使用大都会博物馆MCP服务器

在提示输入字段中，您可以使用@name-of-server-prom-step3或 在ChatGPT UI中，单击“+”按钮，滚动到“”。..more'，选择新创建的Met应用程序，然后输入您的查询。

使用Claude Desktop

通过MCP束（MCPB）

1. 下载 mcpb 文件来自 发布
2. 使用Claude Desktop打开它

或 转到文件->设置->扩展，将.mcpb文件拖动到窗口进行安装

通过npx

将此添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "met-museum": {
      "command": "npx",
      "args": [
        "-y",
        "metmuseum-mcp"
      ]
    }
  }
}

使用LibreChat

在您的 librechat.yaml

mcpServers:
  metmuseum:
    command: npx
    args:
      - -y
      - metmuseum-mcp

示例查询

当连接此服务器时，您可以向AI模型提出以下问题：

Can you help me explore the works of Vincent Van Gogh?
Can you help me explore the Met?
Can you show me a few paintings from the Asian Art department?
Can you find the painting titled "Corridor in the Asylum"?
Can you find any art that has "cat" in the title or features "cats"?

发展

此项目使用 pnpm 为了地方发展和CI。

corepack enable
pnpm install
pnpm run build
pnpm run check

对于非交互式shells/CI运行程序，请使用 CI=true pnpm install --frozen-lockfile.

贡献

欢迎投稿！请随时提交拉取请求。

许可证

此MCP服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。

免责声明

该图书馆与纽约大都会艺术博物馆没有正式关联。它是 大都会艺术博物馆收藏API 使用MCP服务器。