Oorlogsbronnen MCP Server

Oorlogsbronnen MCP 服务

一个 Model Context Protocol（MCP）服务，提供由 AI 驱动的 Oorlogsbronnen（战争档案）数据库访问能力。该服务支持通过自然语言查询荷兰的二战历史档案。

自然语言交互示例

你可以向 AI 助手提出以下问题，探索荷兰二战历史：

• “1940 年 5 月，鹿特丹大轰炸期间发生了什么？”
• “请根据历史记录，讲讲安妮·弗兰克躲藏期间的生活。”
• “给我看看 1944—1945 年荷兰饥荒冬季的照片。”
• “战争期间，我的祖先有人被关押在弗赫特集中营吗？”
• “我下周要去阿纳姆。有哪些与市场花园行动相关的历史遗址值得参观？”
• “查找纳粹占领期间乌得勒支抵抗活动的相关信息。”
• “开始驱逐之前，阿姆斯特丹的犹太家庭日常生活是什么样的？”
• “给我看看 1945 年见证荷兰解放的人们的亲历记录。”
• “有哪些关于战争期间被荷兰家庭藏匿的儿童的记录？”
• “我正在研究二战对荷兰基础设施的影响。能帮我找到有关桥梁和铁路重建的文档吗？”

功能

• 🔍 使用自然语言搜索 Oorlogsbronnen 数据库
• 🏷️ 按内容类型（人物、照片、文章等）筛选结果
• 📊 控制返回结果的数量
• 🤖 提供便于 AI 进一步处理的 JSON 响应

安装

你可以通过以下两种方式安装此服务：

1. 使用带 NPX 包的 Claude Desktop

更新你的 Claude 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）：

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

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

2. 从源代码安装

1. 克隆此仓库：

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

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

4. 更新配置文件（位于 ~/Library/Application Support/Claude/claude_desktop_config.json）以配置 Claude Desktop：

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

将 /absolute/path/to/oorlogsbronnen-mcp 替换为实际的安装路径。

使用示例

此 MCP 服务能够理解自然语言查询，并帮助你探索二战档案。以下是一些可以在 Claude 中使用的查询示例：

基本搜索

• “使用 search_ww2_nl_archives 查找有关阿姆斯特丹抵抗运动的文档”
• “搜索荷兰二战档案，查找 1942 年犹太难民的相关信息”
• “查阅荷兰战争档案，查找盟军空袭的记录”

按类型筛选

• “使用 search_ww2_nl_archives 给我看看鹿特丹解放的照片”
• “在荷兰二战档案中查找有关集中营生活的个人记录”
• “搜索荷兰战争档案，查找有关食物短缺的报纸文章”

特定查询

• “搜索荷兰二战档案，查找有关安妮·弗兰克在阿姆斯特丹生活的文档”
• “使用 search_ww2_nl_archives 查找 1941 年二月罢工的记录”
• “查阅荷兰战争档案，查找有关市场花园行动的信息”

研究示例

1. 个人历史研究：

   Use search_ww2_nl_archives to find any records or documents about the Rosenberg family in Amsterdam between 1940-1945
   

2. 地方历史：

   Search the Dutch WW2 archives for photographs and documents about daily life in Utrecht during the occupation
   

3. 军事行动：

   Use search_ww2_nl_archives to find firsthand accounts and official reports about the Battle of the Scheldt
   

高级用法

你可以组合不同的搜索条件：

Search the Netherlands WW2 archives for photographs and personal accounts of the Dutch famine in 1944-1945, limit to 20 results

API 参考

该服务提供以下 MCP 工具：

search_ww2_nl_archives

一个功能强大的搜索工具，用于查询 Oorlogsbronnen（二战资料）数据库中的荷兰二战相关内容。此工具可用于查找 1940-1945 年的历史文献、照片、个人叙述及其他档案资料。

适用场景：

• 搜索二战期间荷兰发生的特定历史事件
• 查找有关战时人物、地点或组织的信息
• 定位特定时期或地点的照片或文献
• 研究与二战相关的个人或家族史
• 查找有关荷兰抵抗运动、占领或解放的原始资料
• 发现有关战时犹太人生活与迫害的资料
• 研究发生在荷兰的军事行动

参数：

• query（必填）：

  • 类型：字符串
  • 描述：要在档案中查找的主要搜索词或短语
  • 可包含：姓名、地点、日期、事件或描述性词语
  • 示例：
    • “Anne Frank”
    • “1940 年鹿特丹轰炸”
    • “阿姆斯特丹荷兰抵抗运动”
    • “Westerbork 犹太人驱逐”
    • “Market Garden 行动”

• type（可选）：

  • 类型：字符串
  • 描述：按特定内容类型筛选结果
  • 可用类型：
    • “person”：个人传记记录
    • “photo”：历史照片
    • “article”：新闻文章和书面文献
    • “video”：视频影像
    • “object”：实物和物件
    • “location”：地点和地理记录
    • “book”：出版书籍、回忆录和专著
  • 使用时机：需要聚焦于特定类型的历史资料时
  • 默认值：包含所有类型

• count（可选）：

  • 类型：数字
  • 描述：响应中返回的结果数量
  • 最小值：1
  • 最大值：100
  • 默认值：10
  • 使用时机：需要控制返回结果的数量时
  • 注意：较大的数量会提供更全面的结果，但可能需要更长时间处理

响应格式：

{
  "results": [
    {
      "id": string,          // Unique identifier for the record
      "title": string,       // Title or name of the item
      "type": string,        // Content type (person, photo, article, etc.)
      "description": string, // Detailed description (if available)
      "url": string         // Direct link to view the item on Oorlogsbronnen
    }
  ]
}

查询示例及其工具调用：

1. 基本历史搜索：

{
  query: "February Strike 1941",
  type: "article",
  count: 5
}

2. 人物研究：

{
  query: "Rosenberg family Amsterdam Jewish",
  type: "person",
  count: 20
}

3. 照片集搜索：

{
  query: "liberation celebrations Amsterdam Dam Square 1945",
  type: "photo",
  count: 15
}

错误处理：

• 在以下情况下，工具会返回错误消息：
  • 查询为空或包含无效字符
  • 指定的类型不受支持
  • count 超出有效范围（1-100）
  • API 暂时不可用
  • 超出速率限制

最佳实践：

1. 先进行较宽泛的搜索，再用具体词语缩小范围
2. 使用地名聚焦于特定区域
3. 搜索特定事件时加入日期
4. 家族史研究时结合人物姓名和地点
5. 使用类型筛选来聚焦于特定类别的历史资料

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目采用 MIT License 许可；详情请参阅 LICENSE 文件。

致谢

• 感谢 Oorlogsbronnen 提供宝贵历史档案的访问权限
• 感谢 Model Context Protocol（MCP）社区支持 AI 驱动的交互