Oorlogsbronnen WWII Archive MCP Server 使用说明

项目简介

本项目是一个 Model Context Protocol (MCP) 服务器，旨在通过标准化的 MCP 协议，为大型语言模型（LLM）客户端提供访问荷兰二战历史档案数据库 "Oorlogsbronnen" 的能力。用户可以通过自然语言查询，检索相关的历史文档、照片、文章、视频等资源，从而进行二战历史研究或知识探索。

主要功能点

自然语言搜索: 支持使用自然语言提问，例如 "鹿特丹轰炸事件"、"安妮·弗兰克的藏身生活" 等，即可检索相关档案。
多类型内容过滤: 允许用户按内容类型（人物、照片、文章等）筛选搜索结果，精确定位所需信息。
可控结果数量: 用户可以控制每次查询返回的结果数量，方便快速浏览或深度挖掘。
AI友好JSON响应: 服务器返回结构化的 JSON 格式响应，易于 LLM 客户端解析和进一步处理。
资源访问与工具集成: 通过 MCP 协议的资源和工具机制，提供数据访问和查询功能。
提供Prompt模板: 内置 "search_help" Prompt 模板，为用户提供搜索指导和历史背景知识。

安装步骤

方式一：使用 Claude Desktop (NPX Package)

打开 Claude Desktop 客户端。
找到 Claude 的配置文件 'claude_desktop_config.json'，通常位于 '~/Library/Application Support/Claude/' 目录下（macOS）。
编辑该文件，在 'mcpServers' 字段中添加以下配置：

{
  "mcpServers": {
    "oorlogsbronnen-server": {
      "command": "npx",
      "args": [
        "-y",
        "oorlogsbronnen-mcp"
      ]
    }
  }
}

保存配置文件并重启 Claude Desktop 客户端。

方式二：从源码安装

克隆仓库到本地：

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

安装依赖：
```
npm install
```
构建项目：
```
npm run build
```
配置 Claude Desktop 客户端，编辑 'claude_desktop_config.json' 文件，在 'mcpServers' 字段中添加以下配置：

{
  "mcpServers": {
    "oorlogsbronnen-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/oorlogsbronnen-mcp/dist/mcp-server.js"
      ]
    }
  }
}

将 '/absolute/path/to/oorlogsbronnen-mcp' 替换为 oorlogsbronnen-mcp 仓库在您本地的绝对路径。 5. 保存配置文件并重启 Claude Desktop 客户端。

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令及其参数，以便建立连接。以下是针对 Claude Desktop 客户端的 MCP 服务器配置信息：

配置名称 (server name): 'oorlogsbronnen-server' (用户自定义，需与配置文件中保持一致)

启动命令 (command):

方式一 (NPX): 'npx'
方式二 (源码): 'node'

启动参数 (args):

方式一 (NPX):

[
  "-y",
  "oorlogsbronnen-mcp"
]

方式二 (源码):

[
  "/absolute/path/to/oorlogsbronnen-mcp/dist/mcp-server.js"
]

请将 '/absolute/path/to/oorlogsbronnen-mcp/dist/mcp-server.js' 替换为 mcp-server.js 文件在您本地的绝对路径。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端（如 Claude Desktop）中，即可通过以下方式使用该 MCP 服务器：

使用 'search_ww2_nl_archives' 工具进行搜索: 在 LLM 客户端的对话框中，可以使用自然语言结合工具调用来查询荷兰二战档案。例如：
- 'Use search_ww2_nl_archives to find documents about the resistance movement in Amsterdam' (使用 search_ww2_nl_archives 工具查找关于阿姆斯特丹抵抗运动的文档)
- 'Search the Dutch WW2 archives for information about Jewish refugees in 1942' (在荷兰二战档案中搜索 1942 年犹太难民的信息)
- 'Look through the Netherlands war archives for records of Allied bombing raids' (浏览荷兰战争档案，查找盟军轰炸记录)
指定内容类型 (type) 过滤结果: 可以使用 'type' 参数过滤搜索结果的内容类型，例如：
- 'Use search_ww2_nl_archives to show me photographs of the liberation of Rotterdam' (使用 search_ww2_nl_archives 工具展示鹿特丹解放的照片)
- 'Find personal accounts in the Dutch WW2 archives about life in concentration camps' (在荷兰二战档案中查找关于集中营生活的个人叙述)
进行特定主题或人物的查询: 可以直接查询特定的人物或事件，例如：
- 'Search the Dutch WW2 archives for documents about Anne Frank's time in Amsterdam' (在荷兰二战档案中搜索关于安妮·弗兰克在阿姆斯特丹时期的文档)
- 'Use search_ww2_nl_archives to find records of the February Strike of 1941' (使用 search_ww2_nl_archives 工具查找 1941 年二月罢工的记录)
组合搜索条件和限制结果数量: 可以组合多个搜索条件，并使用 'count' 参数限制返回结果的数量，例如：
- 'Search the Netherlands WW2 archives for photographs and personal accounts of the Dutch famine in 1944-1945, limit to 20 results' (在荷兰二战档案中搜索 1944-1945 年荷兰饥荒的照片和个人叙述，限制为 20 条结果)
使用 'oorlogsbronnen://' 资源 URI 获取档案信息: 可以使用 'oorlogsbronnen://' 资源 URI 直接请求服务器返回档案信息，例如 'oorlogsbronnen://Anne Frank'。客户端可以将此 URI 作为资源请求发送到服务器，服务器将返回包含搜索结果的 Markdown 文本。
使用 'search_help' Prompt 模板获取搜索帮助: 客户端可以请求 'search_help' Prompt 模板，获取关于如何有效搜索荷兰二战档案的详细指南和提示，包括搜索技巧、主要历史事件和示例查询等信息。

通过以上方法，用户可以利用该 MCP 服务器，在 LLM 客户端中方便快捷地访问和探索荷兰二战历史档案资源。

关键词