Oorlogsbronnen MCP

🚀 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。

最佳實踐

1. 參數優化：根據具體需求選擇合適的 type 參數以提高搜索效率。
2. 分頁處理：對於大量數據，建議採用分頁方式獲取所有結果。
3. 錯誤處理：在實際應用中，確保對可能的錯誤進行充分處理。

🔧 技術細節

本項目使用了 Python 和 Node.js 技術棧，通過相應的依賴庫實現了服務器的搭建和數據庫的查詢功能。在處理用戶請求時，會對輸入的參數進行驗證，根據不同的情況返回相應的結果和狀態碼。

🤝 貢獻指南

歡迎社區貢獻代碼和建議。如需報告問題或提出功能需求，請聯繫 your.email@example.com 或訪問項目主頁 https://github.com/your-repository。

📄 許可證

本項目遵循 MIT 許可證，具體內容請參見 LICENSE 文件。

通過以上步驟和指南，您可以順利地使用 Oorlogsbronnen MCP 服務器進行二戰歷史檔案的查詢與分析。