Maigret MCP 서버

다양한 공개 소스에서 사용자 계정 정보를 수집하는 강력한 OSINT 도구인 maigret 용 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 소셜 네트워크에서 사용자 이름을 검색하고 URL을 분석하는 도구를 제공합니다. Claude Desktop 과 같은 MCP 호환 애플리케이션과 완벽하게 통합되도록 설계되었습니다.

⚠️ 경고

이 도구는 합법적인 OSINT 조사 목적으로 설계되었습니다. 다음을 참고해 주세요.

• 공개적으로 이용 가능한 정보만 검색하세요
• 개인정보 보호법과 데이터 보호법을 존중하세요
• 검색하는 플랫폼의 서비스 약관을 준수하세요.
• 책임감 있고 윤리적으로 사용하세요
• 일부 사이트에서는 자동 검색 속도를 제한하거나 차단할 수 있음을 유의하세요.

요구 사항

• Node.js(v18 이상)
• 도커
• Docker Desktop이 설치된 macOS, Linux 또는 Windows
• 보고서 디렉토리에 대한 쓰기 액세스

빠른 시작

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Maigret을 자동으로 설치하려면:

지엑스피1

수동 설치

1. Docker 설치:
   • macOS: Docker Desktop 설치
   • Linux: Docker Engine 설치 가이드를 따르세요
2. npm을 통해 서버를 전역으로 설치합니다.

3. 보고서 디렉토리를 만듭니다.

4. Claude Desktop 구성 파일에 다음을 추가합니다.

구성 파일 위치:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

5. Claude Desktop을 다시 시작하세요

대체 설정(소스에서)

소스에서 실행하거나 코드를 수정해야 하는 경우:

1. 복제 및 빌드:

2. Claude Desktop 구성에 다음을 추가합니다.

특징

• 사용자 이름 검색 : 수백 개의 소셜 네트워크와 웹사이트에서 사용자 이름을 검색합니다.
• URL 분석 : URL을 구문 분석하여 정보를 추출하고 연관된 사용자 이름을 검색합니다.
• 다양한 출력 형식 : txt, html, pdf, json, csv 및 xmind 형식 지원
• 사이트 필터링 : 사이트 태그(예: 사진, 데이트, 미국)로 검색 필터링
• Docker 기반 : 다양한 환경에서 안정적이고 일관된 실행

도구

1. 사용자 이름 검색 도구

• 이름: search_username
• 설명: 소셜 네트워크 및 사이트에서 사용자 이름을 검색합니다.
• 매개변수:
  • username (필수): 검색할 사용자 이름
  • format (선택 사항, 기본값: "pdf"): 출력 형식(txt, html, pdf, json, csv, xmind)
  • use_all_sites (선택 사항, 기본값: false): 상위 500개 사이트 대신 사용 가능한 모든 사이트를 사용합니다.
  • tags (선택 사항): 사이트를 필터링하기 위한 태그 배열(예: ["사진", "데이트"])

예:

2. URL 분석 도구

• 이름: parse_url
• 설명: URL을 구문 분석하여 정보를 추출하고 연관된 사용자 이름을 검색합니다.
• 매개변수:
  • url (필수): 분석할 URL
  • format (선택 사항, 기본값: "pdf"): 출력 형식(txt, html, pdf, json, csv, xmind)

예:

문제 해결

도커 문제

1. Docker가 설치되어 실행 중인지 확인하세요.

2. Docker 권한을 확인하세요.
   • 사용자에게 Docker 명령을 실행할 수 있는 권한이 있는지 확인하세요.
   • Linux에서는 docker 그룹에 사용자를 추가합니다: sudo usermod -aG docker $USER

보고서 디렉토리 문제

1. 보고서 디렉토리를 확인하세요.
   • MAIGRET_REPORTS_DIR에 지정된 디렉토리가 존재해야 합니다.
   • 사용자에게는 이 디렉토리에 대한 쓰기 권한이 있어야 합니다.
   • 권한 확인: ls -la /path/to/reports/directory
2. 일반적인 구성 실수:
   • MAIGRET_REPORTS_DIR 환경 변수가 없습니다.
   • 디렉토리가 존재하지 않습니다
   • 잘못된 권한
   • 경로의 후행 슬래시
3. 문제를 해결한 후:
   • 구성 파일을 저장합니다
   • Claude Desktop을 다시 시작하세요

오류 메시지

• "Docker가 설치되지 않았거나 실행 중이 아닙니다": Docker를 설치하고 Docker 데몬을 시작하세요.
• "MAIGRET_REPORTS_DIR 환경 변수를 설정해야 합니다": 구성에 환경 변수를 추가하세요
• "보고서 디렉토리 생성 오류": 디렉토리 권한 및 경로를 확인하세요.
• "maigret 실행 중 오류 발생": Docker 로그를 확인하고 컨테이너에 적절한 권한이 있는지 확인하세요.

기여하다

1. 저장소를 포크하세요
2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
3. 변경 사항을 커밋하세요( git commit -m 'Add amazing feature' )
4. 브랜치에 푸시( git push origin feature/amazing-feature )
5. 풀 리퀘스트 열기

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.