Oorlogsbronnen MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供由 AI 驱动的对 Oorlogsbronnen (战争资源) 数据库的访问。该服务器支持与来自荷兰的二战历史档案进行自然语言交互。

自然语言交互示例

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

• “1940 年 5 月鹿特丹轰炸期间发生了什么？”
• “根据历史记录，告诉我安妮·弗兰克在躲藏期间的生活。”
• “向我展示 1944-1945 年荷兰饥荒的照片。”
• “我的任何祖先在战争期间被囚禁在 Vught 集中营吗？”
• “我下周要去阿纳姆。我应该参观哪些与市场花园行动相关的历史遗址？”
• “查找有关纳粹占领期间乌得勒支抵抗活动的信息。”
• “在驱逐开始之前，阿姆斯特丹犹太家庭的日常生活是怎样的？”
• “向我展示 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 一起使用的示例查询：

基本搜索

• "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" (浏览荷兰战争档案，查找盟军轰炸的记录)

按类型过滤

• "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 Netherlands war archives for newspaper articles about food shortages" (在荷兰战争档案中搜索有关食物短缺的报纸文章)

具体查询

• "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 年 2 月罢工的记录)
• "Look through the Netherlands war archives for information about Operation Market Garden" (浏览荷兰战争档案，查找有关市场花园行动的信息)

研究示例

1. 个人历史研究:

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

   (使用 search_ww2_nl_archives 查找 1940-1945 年间有关阿姆斯特丹 Rosenberg 家族的任何记录或文件)

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_ww2_nl_archives 查找有关斯海尔德河战役的第一手资料和官方报告)

高级用法

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

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

(在荷兰二战档案中搜索 1944-1945 年荷兰饥荒的照片和个人叙述，限制为 20 个结果)

API 参考

服务器公开以下 MCP 工具：

search_ww2_nl_archives

一个强大的搜索工具，旨在查询 Oorlogsbronnen (战争资源) 数据库，以查找荷兰二战相关内容。该工具可用于查找 1940-1945 年的历史文献、照片、个人叙述和其他档案材料。

何时使用此工具：

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

参数：

• query (必需):

  • 类型: string
  • 描述: 在档案中查找的主要搜索词或短语
  • 可以包括: 姓名、地点、日期、事件或描述性术语
  • 示例:
    • "Anne Frank" (安妮·弗兰克)
    • "Rotterdam bombing 1940" (1940 年鹿特丹轰炸)
    • "Dutch resistance Amsterdam" (阿姆斯特丹荷兰抵抗运动)
    • "Jewish deportation Westerbork" (韦斯特博克犹太人驱逐)
    • "Operation Market Garden" (市场花园行动)

• type (可选):

  • 类型: string
  • 描述: 按特定内容类型过滤结果
  • 可用类型:
    • "person": 个人传记记录
    • "photo": 历史照片
    • "article": 新闻文章和书面文件
    • "video": 视频片段
    • "object": 物理文物和物品
    • "location": 地点和地理记录
  • 使用时机: 您需要专注于特定类型的历史材料
  • 默认: 包括所有类型

• count (可选):

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

响应格式:

{
  "results": [
    {
      "id": string,          // 记录的唯一标识符
      "title": string,       // 项目的标题或名称
      "type": string,        // 内容类型（人物、照片、文章等）
      "description": string, // 详细描述（如果可用）
      "url": string         // 在 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
}

错误处理:

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

最佳实践:

1. 从更广泛的搜索开始，然后使用特定术语缩小范围
2. 使用地点名称来关注特定区域
3. 搜索特定事件时包括日期
4. 将人名与地点结合起来进行家族研究
5. 使用类型过滤来关注特定类型的历史材料

贡献

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

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• 感谢 Oorlogsbronnen 提供对其宝贵历史档案的访问
• 感谢模型上下文协议 (MCP) 社区实现 AI 驱动的交互