FamilySearch MCP 서버

FamilySearch API를 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. Claude나 Cursor와 같은 AI 도구가 FamilySearch의 가족력 데이터와 직접 상호 작용할 수 있도록 합니다.

특징

• FamilySearch 자격 증명을 통한 인증
• FamilySearch 가족 트리에서 개인 기록 검색
• 자세한 개인 정보 보기
• 조상과 후손을 탐험하세요
• 역사 기록 검색

필수 조건

• Node.js 16+ 및 npm
• FamilySearch 개발자 계정 및 API 자격 증명
• Family Tree 데이터에 액세스할 수 있는 FamilySearch 사용자 계정

설치

1. 이 저장소를 복제하세요
2. 종속성 설치:

지엑스피1

3. 프로젝트를 빌드하세요:

FamilySearch API 설정

이 도구를 사용하려면 먼저 FamilySearch API 액세스에 등록해야 합니다.

1. FamilySearch 개발자 페이지 로 이동
2. FamilySearch 계정으로 로그인하세요
3. 새로운 애플리케이션을 만듭니다
4. 리디렉션 URI를 https://localhost:8080/oauth-redirect 로 설정합니다(나중에 변경할 수 있음).
5. 클라이언트 ID를 복사하세요. 구성에 필요합니다.

용법

서버를 실행합니다:

그런 다음 MCP를 지원하는 AI 도구(예: Claude 또는 Cursor)에서 FamilySearch 도구를 사용하여 가족 역사 데이터와 상호 작용할 수 있습니다.

구성

MCP를 처음 사용하는 경우 FamilySearch API 자격 증명으로 MCP를 구성해야 합니다.

그런 다음 FamilySearch 사용자 이름과 비밀번호로 인증하세요.

인증이 완료되면 자격 증명은 향후 사용을 위해 ~/.familysearch-mcp/config.json 에 안전하게 저장됩니다.

사용 가능한 MCP 도구

기초적인

• say-hello : 간단한 인사 함수
• configure : FamilySearch API 자격 증명을 설정합니다.
• authenticate : FamilySearch에 로그인
• get-current-user : FamilySearch 계정에 대한 세부 정보를 확인하세요

가계도

• search-persons : FamilySearch 가족 트리에서 개인 검색
• get-person : 특정 사람에 대한 자세한 정보를 봅니다.
• get-ancestors : 개인의 조상(최대 8세대)을 확인합니다.
• get-descendants : 특정인의 후손(최대 3세대) 보기

역사적 기록

• search-records : FamilySearch의 역사 기록 컬렉션 검색

예제 쿼리

보안 공지

FamilySearch 사용자 인증 정보는 로컬 컴퓨터의 ~/.familysearch-mcp/config.json 파일에 저장됩니다. 이 파일을 다른 사람과 공유하지 마세요.

특허

아이에스씨