Gedcommcp

🚀 GEDCOM MCP Server

AIエージェントによる、AIエージェント向けの家系図作成ソリューション。

GEDCOMファイルからの家系データの作成、編集、クエリを行う堅牢なMCPサーバーです。qwen-cliやgemini-cliとも良好に動作します。

このプロジェクトは、AIエージェントが家族の歴史データを扱うための包括的なツールセットを提供し、複雑な家系研究、データ分析、自動文書生成を可能にします。

サーバーは最近、重大なバグの修正、エラーハンドリングの強化、コード品質の向上を行い、完全な下位互換性を維持しています。

いくつかの複雑なプロンプトのサンプル:

   Load gedcom "myfamily.ged"
   Make a complete, detailled biography of <name of some people from the GEDCOM> and his fammily. Use as much as you can from this genealogy, including any notes from him or his relatives. 
   You can try to find some info on Internet to complete the document, add some historical or geographic context, etc. Be as complete as possible to tell us a nice story, easy to read by everyone

または

  Create a new GEDCOM file - save it to "napo.ged"                                                                                                                                              
  Fetch the content of Napoleon I's Wikipedia page                                                                                                                                           
    1. Extract genealogical information about him and people mentioned on his page                                                                                                             
    2. Follow links to other people's Wikipedia pages to gather more information                                                                                                              
    3. Create a comprehensive genealogical record  with as much details as possible. Including birth/death dates and place, family relationships (parents, spouses, children...), occupation, etc, and including a note with the person wikipedia page address and important info about his life                                                                                                                    
    4. Repeat the same process with all people added by previous steps                                                                                                                       
   Continuously save the GEDCOM file as new people are added

または

   Load gedcom "myfamily.ged"
   What's shortest path from John Doe to Bob Smith ?
   And who are their common ancestors ?

✨ 主な機能

• データ管理：GEDCOMファイルを読み込み、解析し、人物、家族、イベント、場所を追加/編集します。
• 強力なクエリ機能：柔軟な条件で人物、家族、イベント、場所を検索します。
• 関係性分析：個人間の関係、共通の祖先、家族のつながりを見つけます。
• 家系図生成：詳細な情報を含む複数世代の祖先と子孫の木を生成します。
• タイムライン生成：人生イベントの年代順のタイムラインを作成します。
• データ分析：包括的な統計、重複検出、名字分析で家系データを分析します。
• 歴史的コンテキスト：日付範囲と歴史的な期間情報を抽出します。
• メタデータ処理：ノート、ソース、詳細なイベント情報を豊富にサポートします。
• データ検証：日付の一貫性とデータの整合性を検証します。
• バッチ操作：効率的な大量処理機能を備えています。

📦 インストール

1. リポジトリをクローンします:

   git clone https://github.com/airy10/GedcomMCP.git
   cd GedcomMCP
   

2. 必要な依存関係をインストールします:

   pip install -r requirements.txt
   

💻 使用例

基本的な使用法

デフォルトのHTTPトランスポートでサーバーを起動するには:

python src/gedcom_mcp/fastmcp_server.py

高度な使用法

stdioトランスポートでサーバーを起動するには:

python src/gedcom_mcp/fastmcp_server.py --transport stdio

HTTPトランスポートで異なるホストまたはポートを指定するには:

python src/gedcom_mcp/fastmcp_server.py --host 0.0.0.0 --port 8080

テストの実行

すべてのテストを実行するには:

python -m pytest tests/

詳細な出力でテストを実行するには:

python -m pytest tests/ -v

特定のテストファイルを実行するには:

python -m pytest tests/test_gedcom_data_access.py

特定のテストを実行するには:

python -m pytest tests/test_gedcom_data_access.py::TestGedcomDataAccess::test_load_gedcom_file

📚 ドキュメント

プロジェクト構造

• src/gedcom_mcp/: メインのソースコード
  • fastmcp_server.py: メインのサーバーアプリケーションとツールの定義
  • gedcom_context.py: GEDCOMの解析コンテキストとキャッシュ管理
  • gedcom_data_access.py: データの取得と抽出関数
  • gedcom_data_management.py: データの変更と管理関数
  • gedcom_analysis.py: 統計分析とレポート関数
  • gedcom_search.py: 関係性の検索とパス分析
  • gedcom_utils.py: データ処理のユーティリティ関数
  • gedcom_constants.py: GEDCOMのイベントと属性の定義
  • gedcom_date_utils.py: 高度な日付解析と検証
  • gedcom_name_utils.py: 名前の解析と正規化
  • gedcom_place_utils.py: 場所名の正規化と地理的階層
  • gedcom_models.py: データモデルと構造
• tests/: 包括的な単体テストと統合テスト
• requirements.txt: プロジェクトの依存関係
• pyproject.toml: ビルド設定
• prompts/: LLMプロンプト生成のテンプレートファイル

最近の改善点

このプロジェクトは、以下のような大幅な改善を行っています:

• ノート処理と属性処理の重大なバグを修正しました。
• 構文エラーを解消し、コード品質を向上させました。
• より良いエラーメッセージでエラーハンドリングを強化しました。
• 本番コードからデバッグ文を削除しました。
• ドキュメントの一貫性を向上させました。
• 完全な下位互換性を維持しました。
• すべての99の自動テストが引き続き合格しています。

🔧 貢献方法

1. リポジトリをフォークします。
2. 新しいブランチを作成して、機能追加またはバグ修正を行います。
3. 変更を加え、説明的なメッセージでコミットします。
4. 変更を自分のフォークにプッシュします。
5. メインのリポジトリにプルリクエストを作成します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。