Oorlogsbronnen MCP 服务器

简介

Oorlogsbronnen MCP 服务器 是一个提供人工智能（AI）交互功能的工具，旨在访问荷兰二战档案数据库。该数据库包含丰富的历史资源，如文件、照片和个人记录等。

安装指南

先决条件

• 操作系统: Linux 或 macOS
• Python 版本: 3.8 或更高版本
• Node.js: 版本 16 或更高

下载与运行

# 下载项目仓库
git clone https://github.com/your-repository.git
cd oorlogsbronnen-mcp-server

# 安装依赖项
pip install -r requirements.txt
npm install

# 启动服务器
python server.py

使用示例

1. 基础查询

const { search_ww2_nl_archives } = require('./mcp');

// 示例查询
search_ww2_nl_archives({
    query: "Anne Frank",
    type: "person",
    count: 5
});

2. 多媒体内容搜索

const { search_ww2_nl_archives } = require('./mcp');

// 查询历史照片
search_ww2_nl_archives({
    query: "liberation celebrations Amsterdam Dam Square 1945",
    type: "photo",
    count: 10
});

API 参考

search_ww2_nl_archives 工具

该工具用于查询 Oorlogsbronnen 数据库中的二战相关资源。

参数说明：

• query: 必填参数，类型为字符串。表示搜索的主要术语或短语。

  • 示例: "Rotterdam bombing 1940" 或 "Jewish deportation Westerbork"

• type: 可选参数，类型为字符串。用于筛选特定类型的结果。

  • 可用值包括："person", "photo", "article", "video", "object", "location"
  • 默认情况: 不设限制，返回所有类型

• count: 可选参数，类型为数字。控制返回结果的数量。

  • 范围: 最少1，最多100
  • 默认值: 10

响应格式：

{
  "results": [
    {
      "id": string,          // 唯一标识符
      "title": string,       // 标题或名称
      "type": string,        // 内容类型
      "description": string, // 描述信息
      "url": string           // 资源 URL
    }
  ]
}

错误处理

• 参数缺失: 当必填参数未提供时，服务器返回状态码400。
• 无效类型: 如果指定的类型不存在，返回状态码400。
• 资源未找到: 当无匹配结果时，返回空 results 数组和状态码200。

最佳实践

1. 参数优化: 根据具体需求选择合适的 type 参数以提高搜索效率。
2. 分页处理: 对于大量数据，建议采用分页方式获取所有结果。
3. 错误处理: 在实际应用中，确保对可能的错误进行充分处理。

贡献指南

欢迎社区贡献代码和建议。如需报告问题或提出功能需求，请联系 your.email@example.com 或访问项目主页 https://github.com/your-repository。

许可证信息

本项目遵循 MIT 许可证，具体内容请参见 LICENSE 文件。

通过以上步骤和指南，您可以顺利地使用 Oorlogsbronnen MCP 服务器进行二战历史档案的查询与分析。