Oorlogsbronnen MCP

🚀 Oorlogsbronnen MCP Server

The Oorlogsbronnen MCP Server is a tool that provides artificial intelligence (AI) interaction capabilities, aiming to access the Dutch World War II archives database. This database contains a wealth of historical resources, such as documents, photos, and personal records.

🚀 Quick Start

The Oorlogsbronnen MCP Server offers a convenient way to access the Dutch World War II archives database. Follow the steps below to get started.

✨ Features

• AI Interaction: Leverage artificial intelligence for efficient queries.
• Rich Database: Access a wide range of historical resources including documents, photos, and personal records.
• Flexible Search: Use various parameters to filter and retrieve specific results.

📦 Installation

Prerequisites

• Operating System: Linux or macOS
• Python Version: 3.8 or higher
• Node.js: Version 16 or higher

Download and Run

# Clone the project repository
git clone https://github.com/your-repository.git
cd oorlogsbronnen-mcp-server

# Install dependencies
pip install -r requirements.txt
npm install

# Start the server
python server.py

💻 Usage Examples

Basic Usage

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

// Example query
search_ww2_nl_archives({
    query: "Anne Frank",
    type: "person",
    count: 5
});

Advanced Usage

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

// Query historical photos
search_ww2_nl_archives({
    query: "liberation celebrations Amsterdam Dam Square 1945",
    type: "photo",
    count: 10
});

📚 Documentation

search_ww2_nl_archives Tool

This tool is used to query World War II-related resources in the Oorlogsbronnen database.

Parameter Description:

• query: Required parameter, of type string. Represents the main term or phrase for the search.

  • Example: "Rotterdam bombing 1940" or "Jewish deportation Westerbork"

• type: Optional parameter, of type string. Used to filter specific types of results.

  • Available values include: "person", "photo", "article", "video", "object", "location"
  • Default: No restriction, returns all types

• count: Optional parameter, of type number. Controls the number of returned results.

  • Range: Minimum 1, maximum 100
  • Default value: 10

Response Format:

{
  "results": [
    {
      "id": string,          // Unique identifier
      "title": string,       // Title or name
      "type": string,        // Content type
      "description": string, // Description information
      "url": string           // Resource URL
    }
  ]
}

🔧 Technical Details

Error Handling

• Missing Parameters: When a required parameter is not provided, the server returns status code 400.
• Invalid Type: If the specified type does not exist, status code 400 is returned.
• Resource Not Found: When there are no matching results, an empty results array and status code 200 are returned.

Best Practices

1. Parameter Optimization: Select the appropriate type parameter according to specific needs to improve search efficiency.
2. Pagination: For large amounts of data, it is recommended to use pagination to retrieve all results.
3. Error Handling: In practical applications, ensure that possible errors are fully handled.

🤝 Contribution Guide

We welcome the community to contribute code and suggestions. If you need to report an issue or propose a feature request, please contact your.email@example.com or visit the project homepage at https://github.com/your-repository.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for specific details.

By following the above steps and guidelines, you can successfully use the Oorlogsbronnen MCP Server to query and analyze World War II historical archives.