🚀 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 服务器进行二战历史档案的查询与分析。