战争资料MCP服务器

一个提供AI驱动访问战争资料（Oorlogsbronnen）数据库的模型上下文协议（MCP）服务器。该服务器使用户能够以自然语言与荷兰二战历史档案进行交互。

自然语言交互示例

向你的AI助手提出如下问题来探索荷兰二战历史：

• “1940年5月鹿特丹轰炸期间发生了什么？”
• “根据历史记录告诉我关于安妮·弗兰克在藏身时的生活。”
• “展示1944-1945年荷兰饥荒的照片。”
• “我的祖先中有人在战争期间被关押在Vught集中营吗？”
• “我下周要去阿纳姆。有哪些与市场花园行动相关的值得一看的历史遗迹？”
• “找到关于纳粹占领期间乌得勒支抵抗活动的信息。”
• “在开始驱逐之前，阿姆斯特丹犹太家庭的日常生活是什么样的？”
• “展示那些目睹1945年荷兰解放的人的第一手账户。”
• “有关于战争期间被荷兰家庭隐藏的孩子的记录吗？”
• “我在研究二战对荷兰基础设施的影响。你能找到关于桥梁和铁路重建的文件吗？”

特性

• 🔍 在战争资料数据库中进行自然语言搜索
• 🏷️ 根据内容类型（人物、照片、文章等）过滤结果
• 📊 控制返回的结果数量
• 🤖 适合进一步处理的AI友好型JSON响应

安装

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

1. 使用Claude Desktop和NPX包

更新你的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. 更新Claude Desktop配置文件（位于~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "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年2月罢工的记录"
• "浏览荷兰战争档案，获取关于市场花园行动的信息"

研究示例

1. 个人历史研究：

   使用search_ww2_nl_archives查找1940-1945年间阿姆斯特丹罗森伯格家族的任何记录或文件
   

2. 地方历史：

   搜索荷兰二战档案，获取关于占领期间乌得勒日生活状况的照片和文件
   

3. 军事行动：

   使用search_ww2_nl_archives查找关于斯海尔德河战役的一手账户和官方报告
   

高级用法

你可以结合不同的搜索标准：

搜索荷兰二战档案，获取关于1944-1945年荷兰饥荒的照片和个人账户，限制结果数量为20个

API参考

服务器公开了以下MCP工具：

search_ww2_nl_archives

一个强大的搜索工具，设计用于查询战争资料（Oorlogsbronnen）数据库中的荷兰二战相关内容。此工具可用于查找历史文件、照片、个人账户和其他档案材料，时间跨度为1940-1945年。

何时使用此工具：

• 搜索荷兰二战期间的具体历史事件
• 查找关于战争期间的人物、地点或组织的信息
• 定位特定时间段或地点的照片或文件
• 研究与二战相关的个人或家庭历史
• 查找关于荷兰抵抗、占领或解放的一手资料
• 发现关于战争期间犹太人生活和迫害的材料
• 研究在荷兰发生的军事行动

参数：

• query（必需）：

  • 类型：字符串
  • 描述：在档案中要查找的主要搜索词或短语
  • 可以包括：姓名、地点、日期、事件或描述性词语
  • 示例：
    • "安妮·弗兰克"
    • "1940年鹿特丹轰炸"
    • "阿姆斯特丹抵抗"
    • "威斯特博克犹太人驱逐"
    • "市场花园行动"

• type（可选）：

  • 类型：字符串
  • 描述：按特定内容类型过滤结果
  • 可用类型：
    • "person"：个人传记记录
    • "photo"：历史照片
    • "article"：新闻文章和书面文件
    • "video"：视频片段
    • "object"：实物文物和物品
    • "location"：地点和地理记录
    • "book"：出版书籍、回忆录和专著
  • 使用场景：当你需要专注于特定类型的档案材料时
  • 默认值：所有类型均包括

• count（可选）：

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

响应格式：

{
  "results": [
    {
      "id": 字符串,          // 记录的唯一标识符
      "title": 字符串,       // 条目的标题或名称
      "type": 字符串,        // 内容类型（人物、照片、文章等）
      "description": 字符串, // 详细描述（如果可用）
      "url": 字符串         // 直接链接到Oorlogsbronnen上的条目
    }
  ]
}

示例查询及其工具调用：

1. 基础历史搜索：

{
  query: "1941年2月罢工",
  type: "article",
  count: 5
}

2. 人物研究：

{
  query: "阿姆斯特丹罗森伯格家族犹太人",
  type: "person",
  count: 20
}

3. 照片集搜索：

{
  query: "1945年阿姆斯特丹大坝广场解放庆典",
  type: "photo",
  count: 15
}

错误处理：

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

最佳实践：

1. 从广泛的搜索开始，然后使用具体术语缩小范围
2. 使用地名来聚焦特定区域
3. 搜索特定事件时包含日期
4. 结合人名和地点进行家庭研究
5. 使用类型筛选来专注于特定种类的历史材料

贡献

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

许可证

本项目采用MIT许可证——详情见LICENSE文件。

致谢

• Oorlogsbronnen为提供其宝贵的档案访问权限
• 模型上下文协议（MCP）社区为实现AI驱动的交互提供了支持