JinDaGe - oorlogsbronnen-mcp MCP Details

article

README

🚀 Oorlogsbronnen MCP 服务器

Oorlogsbronnen MCP 服务器是一个强大的工具，它提供人工智能（AI）交互功能，能让用户轻松访问荷兰二战档案数据库。该数据库内包含丰富多样的历史资源，如文件、照片和个人记录等，为二战历史研究提供了有力支持。

🚀 快速开始

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

💻 使用示例

基础用法

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

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

高级用法

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

📚 详细文档

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。

最佳实践

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

🔧 技术细节

本项目使用了 Python 和 Node.js 技术栈，通过相应的依赖库实现了服务器的搭建和数据库的查询功能。在处理用户请求时，会对输入的参数进行验证，根据不同的情况返回相应的结果和状态码。

🤝 贡献指南

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

📄 许可证

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

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

oorlogsbronnen-mcp