Oorlogsbronnen MCP

🚀 Oorlogsbronnen MCP サーバー

Oorlogsbronnen MCP サーバーは、人工知能（AI）を介してオランダの第二次世界大戦のアーカイブデータベースにアクセスするためのツールです。このデータベースには、文書、写真、個人記録など、豊富な歴史資料が含まれています。

🚀 クイックスタート

Oorlogsbronnen MCP サーバーを使用することで、第二次世界大戦に関連するオランダのアーカイブデータベースを検索できます。以下のセクションでは、インストール方法、使用例、API リファレンスなどを説明します。

✨ 主な機能

• オランダの第二次世界大戦のアーカイブデータベースへのアクセス
• さまざまなタイプの歴史資料（人物、写真、記事など）の検索
• 検索結果の数を制御する機能

📦 インストール

前提条件

• オペレーティングシステム: 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. エラー処理: 実際のアプリケーションでは、可能なエラーを十分に処理するようにしてください。

コントリビューションガイド

コミュニティからのコードや提案を歓迎します。問題を報告するか機能要求を提出する場合は、your.email@example.com に連絡するか、プロジェクトのホームページ https://github.com/your-repository を訪問してください。

📄 ライセンス

このプロジェクトは MIT ライセンスに準拠しています。詳細については、LICENSE ファイルを参照してください。

以上の手順とガイドに従うことで、Oorlogsbronnen MCP サーバーを使用して第二次世界大戦の歴史アーカイブを検索および分析することができます。