Oorlogsbronnen MCP Server

Oorlogsbronnen MCP サーバー

Oorlogsbronnen（戦争資料）データベースへのAIを活用したアクセスを提供する、Model Context Protocol（MCP）サーバーです。このサーバーを使うと、オランダの第二次世界大戦に関する歴史資料と自然言語でやり取りできます。

自然言語でのやり取りの例

オランダの第二次世界大戦の歴史を調べるには、AI アシスタントに次のような質問をしてください。

• 「1940年5月のロッテルダム爆撃では何が起きましたか？」
• 「歴史的記録に基づいて、アンネ・フランクの隠れ家での生活について教えてください。」
• 「1944年から1945年にかけてのオランダの飢餓の冬の写真を見せてください。」
• 「戦時中、私の先祖の誰かがフフト収容所に収監されていましたか？」
• 「来週アーネムを訪れます。マーケット・ガーデン作戦に関連する史跡で、訪れるべき場所を教えてください。」
• 「ナチス占領下のユトレヒトでのレジスタンス活動について情報を探してください。」
• 「強制移送が始まる前、アムステルダムのユダヤ人家族の日常生活はどのようなものでしたか？」
• 「1945年のオランダ解放を目撃した人々の証言を見せてください。」
• 「戦時中にオランダの家族に匿われた子どもたちに関する記録はありますか？」
• 「第二次世界大戦がオランダのインフラに与えた影響を調べています。橋や鉄道の復旧に関する文書を探してもらえますか？」

機能

• 🔍 Oorlogsbronnen データベースを自然言語で検索
• 🏷️ コンテンツの種類（人物、写真、記事など）で検索結果を絞り込み
• 📊 返される検索結果の件数を指定
• 🤖 さらなる処理に適した、AI フレンドリーなJSONレスポンス

インストール

このサーバーは2つの方法でインストールできます。

1. NPX パッケージを使用して Claude Desktop にインストール

Claude の設定ファイル（~/Library/Application Support/Claude/claude_desktop_config.json）を更新します。

{
  "mcpServers": {
    "oorlogsbronnen-server": {
      "command": "npx",
      "args": [
        "-y",
        "oorlogsbronnen-mcp"
      ]
    }
  }
}

設定を更新したら、変更を反映するために Claude Desktop を再起動してください。

2. ソースからインストール

1. このリポジトリをクローンします。

git clone https://github.com/r-huijts/oorlogsbronnen-mcp.git
cd oorlogsbronnen-mcp

2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

4. 設定ファイル（~/Library/Application Support/Claude/claude_desktop_config.json にあります）を更新して、Claude Desktop を設定します。

{
  "mcpServers": {
    "oorlogsbronnen-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/oorlogsbronnen-mcp/dist/mcp-server.js"
      ]
    }
  }
}

/absolute/path/to/oorlogsbronnen-mcp を、実際にインストールしたパスに置き換えてください。

使用例

この MCP サーバーは自然言語のクエリを理解し、第二次世界大戦のアーカイブを調べる際に役立ちます。Claude で使用できるクエリの例をいくつか紹介します。

基本的な検索

• 「search_ww2_nl_archives を使って、アムステルダムのレジスタンス運動に関する文書を探してください」
• 「1942年のユダヤ人難民に関する情報をオランダの第二次世界大戦アーカイブから検索してください」
• 「連合軍による空爆の記録を、オランダの戦争アーカイブから探してください」

種類による絞り込み

• 「search_ww2_nl_archives を使って、ロッテルダム解放の写真を見せてください」
• 「強制収容所での生活に関する個人の証言を、オランダの第二次世界大戦アーカイブから探してください」
• 「食料不足に関する新聞記事を、オランダの戦争アーカイブから検索してください」

特定のクエリ

• 「アンネ・フランクがアムステルダムで過ごした時期に関する文書を、オランダの第二次世界大戦アーカイブから検索してください」
• 「search_ww2_nl_archives を使って、1941年の二月ストライキの記録を探してください」
• 「マーケット・ガーデン作戦に関する情報を、オランダの戦争アーカイブから探してください」

調査の例

1. 個人史の調査：

   Use search_ww2_nl_archives to find any records or documents about the Rosenberg family in Amsterdam between 1940-1945
   

2. 地域史：

   Search the Dutch WW2 archives for photographs and documents about daily life in Utrecht during the occupation
   

3. 軍事作戦：

   Use search_ww2_nl_archives to find firsthand accounts and official reports about the Battle of the Scheldt
   

高度な使い方

複数の検索条件を組み合わせることができます。

Search the Netherlands WW2 archives for photographs and personal accounts of the Dutch famine in 1944-1945, limit to 20 results

API リファレンス

このサーバーは、次の MCP ツールを公開しています。

search_ww2_nl_archives

オランダの第二次世界大戦関連コンテンツを検索するために、Oorlogsbronnen（戦争資料）データベースを照会する強力な検索ツールです。このツールを使うと、1940～1945年の歴史的文書、写真、個人の証言など、さまざまなアーカイブ資料を見つけられます。

このツールを使用する場面：

• 第二次世界大戦中のオランダにおける特定の歴史的事件を検索する場合
• 戦時中の人物、場所、組織に関する情報を探す場合
• 特定の時期や場所の写真または文書を探す場合
• 第二次世界大戦に関連する個人や家族の歴史を調査する場合
• オランダのレジスタンス、占領、解放に関する一次資料を探す場合
• 戦時中のユダヤ人の生活や迫害に関する資料を見つける場合
• オランダで実施された軍事作戦を調査する場合

パラメーター：

• query（必須）：

  • 型：string
  • 説明：アーカイブ内で検索する主要な検索語またはフレーズ
  • 含められるもの：名前、場所、日付、出来事、説明的な用語
  • 例：
    • "Anne Frank"
    • "Rotterdam bombing 1940"
    • "Dutch resistance Amsterdam"
    • "Jewish deportation Westerbork"
    • "Operation Market Garden"

• type（任意）：

  • 型：string
  • 説明：特定のコンテンツタイプで結果を絞り込みます
  • 利用可能なタイプ：
    • "person"：個人の経歴に関する記録
    • "photo"：歴史的な写真
    • "article"：ニュース記事および文書
    • "video"：映像資料
    • "object"：実物の遺物や物品
    • "location"：場所や地理に関する記録
    • "book"：刊行された書籍、回顧録、専門書
  • 使用する場面：特定の種類の歴史資料に絞り込む必要がある場合
  • デフォルト：すべてのタイプが含まれます

• count（任意）：

  • 型：number
  • 説明：応答で返す結果の数
  • 最小値：1
  • 最大値：100
  • デフォルト：10
  • 使用する場面：返される結果の量を調整する必要がある場合
  • 注：数を増やすと、より包括的な結果が得られますが、処理に時間がかかる場合があります

応答形式：

{
  "results": [
    {
      "id": string,          // Unique identifier for the record
      "title": string,       // Title or name of the item
      "type": string,        // Content type (person, photo, article, etc.)
      "description": string, // Detailed description (if available)
      "url": string         // Direct link to view the item on Oorlogsbronnen
    }
  ]
}

クエリとツール呼び出しの例：

1. 基本的な歴史検索：

{
  query: "February Strike 1941",
  type: "article",
  count: 5
}

2. 人物の調査：

{
  query: "Rosenberg family Amsterdam Jewish",
  type: "person",
  count: 20
}

3. 写真コレクションの検索：

{
  query: "liberation celebrations Amsterdam Dam Square 1945",
  type: "photo",
  count: 15
}

エラー処理：

• 次の場合、ツールはエラーメッセージを返します：
  • クエリが空、または無効な文字を含んでいる
  • 指定されたタイプがサポートされていない
  • count が有効な範囲（1～100）外である
  • API が一時的に利用できない
  • レート制限を超過している

ベストプラクティス：

1. 広い範囲で検索を始め、具体的な用語で絞り込みます
2. 特定の地域に絞り込むには、場所の名前を使います
3. 特定の出来事を検索するときは、日付を含めます
4. 家族について調べるときは、人物名と場所を組み合わせます
5. 特定の種類の歴史資料に絞り込むには、type フィルターを使います

コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細については LICENSE ファイルをご覧ください。

謝辞

• 貴重な歴史的アーカイブへのアクセスを提供してくださった Oorlogsbronnen
• AI を活用した対話を可能にしている Model Context Protocol（MCP）コミュニティ