Case Chronology MCP Server

Case Chronology MCP サーバー

ケースの出来事の時系列を作成・管理するための Model Context Protocol（MCP）サーバーです。複雑な事件の経緯を整理する必要がある法律専門家に最適です。

機能

• スマートな日付解析：正確な日付、概算の日付、月、四半期など、さまざまな日付形式に対応します
• 文書解析：貼り付けた文書から日付と出来事を自動的に抽出します
• 複数形式でのエクスポート：Markdown、CSV、簡易テキスト、JSON 形式で時系列を生成します
• 高度な検索：日付範囲、当事者、キーワード、タグで検索できます
• 当事者・文書のインデックス化：関係者やソース文書からすばやく検索できます

インストール

オプション 1：uvx を使用（推奨）

インストールは不要です。サーバーは uvx で直接実行できます。

オプション 2：従来のインストール方法

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

git clone https://github.com/medelman17/case-chronology-mcp.git
cd case-chronology-mcp

2. uv でインストールします：

uv pip install -e .

または、pip を使用します：

pip install -r requirements.txt

設定

Claude Desktop の設定にサーバーを追加します：

Windows ユーザー向け — 手順

ステップ 1：ダウンロードとセットアップ

1. PowerShell または Command Prompt を開きます
2. インストール先（例：GitHub フォルダー）に移動します：

   cd C:\Users\%USERNAME%\GitHub
   

3. リポジトリをクローンします：

   git clone https://github.com/medelman17/case-chronology-mcp.git
   cd case-chronology-mcp
   

4. 重要： セットアップスクリプトを実行します（仮想環境を作成し、依存関係をインストールします）：

   .\setup.bat
   

   完了するまで待ちます。最後に「Setup complete!」と表示されます。

ステップ 2：Claude Desktop を設定

1. Claude Desktop を開きます
2. Settings（左下の歯車アイコン）に移動します
3. Developer タブをクリックします
4. MCP Servers Configuration セクションを見つけます
5. 次の設定を追加します（%USERNAME% を実際のユーザー名に置き換えてください）：

{
  "mcpServers": {
    "case-chronology": {
      "command": "C:\\Users\\%USERNAME%\\GitHub\\case-chronology-mcp\\run_server.bat"
    }
  }
}

たとえば、ユーザー名が mikee の場合は、次のようにします：

{
  "mcpServers": {
    "case-chronology": {
      "command": "C:\\Users\\mikee\\GitHub\\case-chronology-mcp\\run_server.bat"
    }
  }
}

6. 設定を保存します
7. Claude Desktop を再起動します

ステップ 3：動作確認

Claude Desktop を再起動すると、Case Chronology サーバーが接続されていることを確認できます。次のように尋ねてみてください：

「出来事を追加してください：2024 年 1 月 15 日 — ABC Corp と XYZ LLC の間で契約を締結」

Mac/Linux ユーザー

オプション 1：uvx を使用（推奨）

{
  "mcpServers": {
    "case-chronology": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/medelman17/case-chronology-mcp.git",
        "case-chronology-mcp"
      ]
    }
  }
}

オプション 2：ローカルにインストール

{
  "mcpServers": {
    "case-chronology": {
      "command": "python",
      "args": ["/full/path/to/case-chronology-mcp/chronology_server.py"]
    }
  }
}

使用例

出来事の追加

シンプルな出来事：

"Add event: March 15, 2023 - Smith emails Jones about breach of contract. Parties: Smith, Jones"

詳細を含む出来事：

"Add event: 3/15/2023 - Contract breach notification sent. Parties: Smith, Jones. Tag: breach, notice. Significance: First formal notice of breach"

文書の解析

"Parse this email and add events to the chronology:

From: Bob Smith
To: Alice Jones
Date: March 15, 2023

I am writing to inform you that your failure to deliver by March 1, 2023 constitutes a breach..."

時系列の検索

• 「2023 年 3 月のすべての出来事を表示して」
• 「Smith が関係する出来事を検索して」
• 「'breach' タグが付いた出来事を検索して」
• 「2023 年 1 月 1 日から 2023 年 6 月 30 日までの出来事を表示して」

エクスポート

• 「時系列を Markdown としてエクスポートして」
• 「簡易版の時系列をください」
• 「Excel 用に CSV としてエクスポートして」
• 「JSON データ全体をエクスポートして」

対応する日付形式

サーバーはさまざまな日付形式をインテリジェントに解析します：

• 正確な日付：3/15/2023、March 15, 2023
• 概算の日付：early March 2023、mid March 2023、late March 2023
• 月単位の精度：March 2023
• 四半期単位の精度：Q1 2023
• 概算を示す表現：around 3/15/2023、approximately March 2023

データの保存

イベントは、サーバーと同じディレクトリにある case_chronology.json に保存されます。このファイルは初回使用時に自動的に作成されます。

トラブルシューティング（Windows）

❌ 「仮想環境が見つかりません」というエラー

• 最初に .\setup.bat を実行したことを確認してください
• プロジェクトディレクトリに venv フォルダーがあることを確認してください

❌ 「Python が見つかりません」というエラー

• python.org から Python 3.10 以降をインストールしてください
• インストール時に「Add Python to PATH」にチェックを入れてください

❌ 「セットアップに失敗しました」というエラー

• PowerShell を管理者として実行してみてください
• または、手動で環境を作成してください：

  python -m venv venv
  venv\Scripts\activate
  pip install -r requirements.txt
  

❌ サーバーがすぐに切断される

• Claude Desktop の設定でパスが正しいことを確認してください
• JSON のパスではバックスラッシュを 2 つ（\\）使用してください
• パス内のユーザー名が正しいことを確認してください

❌ 「アクセスが拒否されました」というエラー

• PowerShell を管理者として実行してください
• または、別の場所（ドキュメントフォルダーなど）へのインストールを試してください

テスト

MCP Inspector でサーバーをテストします：

npx @modelcontextprotocol/inspector python chronology_server.py

利用可能なツール

• add_event - 年表に単一のイベントを追加します
• parse_document - 文書テキストからイベントを抽出します
• search_timeline - さまざまな条件でイベントを検索します
• get_timeline_summary - 概要の統計情報を取得します
• export_chronology - さまざまな形式でエクスポートします
• update_event - 既存のイベントを変更します
• delete_event - 年表からイベントを削除します

ライセンス

MIT