Louvre MCP服务器使用说明

项目简介

Louvre MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为 LLM 客户端提供访问卢浮宫艺术品收藏的上下文信息和功能。通过此服务器，LLM 应用可以方便地查询卢浮宫的艺术品信息，包括搜索艺术品、获取艺术品详情和检索艺术品图像。

主要功能点

艺术品搜索: 允许用户通过关键词搜索卢浮宫收藏的艺术品。
艺术品详情: 提供特定艺术品的详细信息，包括标题、艺术家、创作日期、材质、尺寸、描述和相关图片链接。
艺术品图像检索: 支持获取艺术品的缩略图或全尺寸图像。

安装步骤

安装Node.js和npm: 确保您的系统已安装 Node.js 和 npm (Node包管理器)。
克隆仓库: 将仓库 'https://github.com/oliviermichel/louvre-mcp' 克隆到本地。
安装依赖: 在项目根目录下，打开终端并运行以下命令安装项目依赖：
```
npm install
```

服务器配置

MCP 客户端需要配置以下信息以连接到 Louvre MCP 服务器。以下是 'config.json' 的配置示例，请根据实际情况调整：

{
  "serverName": "louvreMCP",  // MCP 服务器名称，与服务器代码中定义的一致
  "command": "npm",         // 启动服务器的命令，这里使用 npm
  "args": ["start"]        // 启动服务器命令的参数，npm start 运行 package.json 中定义的 start 脚本
}

配置说明:

'serverName': 必须与 'build/index.js' 或 'src/index.ts' 文件中 'McpServer' 实例化的 'name' 属性值 "louvreMCP" 一致。
'command': 指定用于启动服务器进程的命令。由于项目使用 npm 管理，并且在 'package.json' 中定义了 'start' 脚本，因此这里使用 'npm' 命令。
'args': 提供给 'command' 的参数。'npm start' 命令通过运行 'package.json' 中 scripts 字段下定义的 'start' 脚本来启动服务器。

基本使用方法

构建项目: 在项目根目录下运行以下命令编译 TypeScript 代码：
```
npm run build
```
启动服务器: 在项目根目录下运行以下命令启动 Louvre MCP 服务器：
```
npm start
```
服务器成功启动后，将在终端输出 "Louvre MCP Server running on stdio"。
MCP客户端交互: 配置您的 MCP 客户端，使其连接到该服务器。客户端可以通过 JSON-RPC 协议调用以下工具 (Tools) 与服务器交互：
- 'search-artwork': 搜索艺术品。需要提供 'query' (搜索关键词) 和可选的 'page' (页码) 参数。
- 'get-artwork-detail': 获取艺术品详情。需要提供 'id' (艺术品ID) 参数。
- 'get-artwork-images': 获取艺术品图像。需要提供 'id' (艺术品ID)，可选参数 'type' (图像类型: "thumbnail", "full", "all") 和 'position' (图像位置)。
客户端发送符合 MCP 协议的 JSON-RPC 请求，服务器将返回包含艺术品信息的 JSON-RPC 响应。

示例 (MCP客户端调用 'search-artwork' 工具):

以下是一个简化的 MCP 客户端请求示例 (实际客户端需要按照 MCP 协议格式构造完整的 JSON-RPC 请求):

{
  "method": "call",
  "params": {
    "tool": "search-artwork",
    "arguments": {
      "query": "Mona Lisa"
    }
  }
}

服务器将返回包含搜索结果的 JSON-RPC 响应，其中 'content' 字段包含搜索到的艺术品列表。

关键词