Gedcommcp

🚀 GEDCOM MCP Server

本項目由AI智能體驅動，專為AI智能體提供強大的家譜數據處理能力。它是一個功能強大的MCP服務器，可用於從GEDCOM文件中創建、編輯和查詢家譜數據，並且能與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. 分叉（Fork）倉庫。
2. 為你的功能或錯誤修復創建一個新分支。
3. 進行更改並使用描述性消息提交。
4. 將更改推送到你的分叉倉庫。
5. 向主倉庫創建拉取請求。

📄 許可證

本項目採用MIT許可證。