🔍 OSINT Tools MCP Server

OSINT 도구 여러 개를 AI 어시스턴트(예: Claude)에 노출하는 포괄적인 MCP 서버입니다. 이 서버를 통해 AI는 업계 표준 OSINT 도구를 사용하여 정교한 정찰 및 정보 수집 작업을 수행할 수 있습니다.

🛠️ 사용 가능한 도구

🔍 Sherlock - 사용자명 검색

399개 이상의 소셜 미디어 플랫폼 및 웹사이트에서 사용자명을 검색합니다. 디지털 발자국 분석에 적합합니다.

입력: 사용자명
출력: 사용자명이 존재하는 플랫폼 목록

📧 Holehe - 이메일 확인

120개 이상의 플랫폼에 이메일이 등록되어 있는지 확인합니다. 빠르고 정확합니다.

입력: 이메일 주소
출력: 이메일이 등록된 플랫폼 목록

🕷️ SpiderFoot - 종합 OSINT

OSINT의 스위스 군용 칼입니다. 자동 대상 유형 감지와 함께 심층 정찰을 수행합니다.

입력: IP, 도메인, 이메일, 전화번호, 사용자명, 사람 이름, 비트코인 주소 또는 네트워크 블록
출력: 포괄적인 정보 보고서
⚠️ 참고: SpiderFoot 전체 검사는 5~30분이 소요될 수 있습니다. 인내심을 가지세요!

🔎 GHunt - Google 계정 정보

이메일 또는 Google ID로 Google 계정에서 정보를 추출합니다.

입력: 이메일 또는 Google ID
출력: Google 계정 세부 정보 및 관련 정보

🌐 Maigret - 고급 사용자명 검색

3000개 이상의 사이트를 검색하며, 거짓 긍정 감지 및 상세 분석을 제공합니다.

입력: 사용자명
출력: 신뢰도 점수가 포함된 상세 보고서

🌾 TheHarvester - 도메인 인텔리전스

공개 소스에서 이메일, 서브도메인, 호스트, 직원 이름 등을 수집합니다.

입력: 도메인 또는 회사 이름
출력: 포괄적인 도메인 인텔리전스

🐦 Blackbird - 빠른 사용자명 OSINT

581개 사이트에서 사용자명 정찰을 위한 초고속 검색을 수행합니다.

입력: 사용자명
출력: 빠른 프로필 발견 결과

🚀 설치

MCP 서버 설정

이 저장소를 클론합니다:

git clone https://github.com/frishtik/osint-tools-mcp-server.git
cd osint-tools-mcp-server

의존성을 설치합니다:

pip install -r requirements.txt

이렇게 하면 Sherlock, Holehe, Maigret, TheHarvester가 자동으로 설치됩니다.

Claude Desktop을 구성합니다:

Claude Desktop 구성 파일(~/Library/Application Support/Claude/claude_desktop_config.json on macOS)에 다음을 추가합니다:

{
  "mcpServers": {
    "osint-tools": {
      "command": "python",
      "args": ["/path/to/osint-tools-mcp-server/src/osint_tools_mcp_server.py"],
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

Claude Desktop을 다시 시작하여 새 MCP 서버를 로드합니다.

추가 도구를 위한 사전 요구 사항

일부 도구는 복잡성으로 인해 수동 설치가 필요합니다:

SpiderFoot

git clone https://github.com/smicallef/spiderfoot.git /opt/spiderfoot
cd /opt/spiderfoot
pip install -r requirements.txt

GHunt

git clone https://github.com/mxrch/GHunt.git /opt/ghunt
cd /opt/ghunt
pip install -r requirements.txt

Blackbird

git clone https://github.com/p1ngul1n0/blackbird.git /opt/blackbird
cd /opt/blackbird
pip install -r requirements.txt

🎮 사용 팁

시작하기

AI로 OSINT 작업을 하는 것은 다소 예술에 가깝습니다. 최상의 결과를 얻는 방법은 다음과 같습니다:

Holehe로 간단히 시작하기

Holehe 도구부터 시작하는 것을 추천합니다. 빠르고 신뢰할 수 있으며 즉각적인 결과를 제공합니다:

"[email protected]이 어떤 플랫폼에 등록되어 있는지 확인해줘"

사용자명 검색으로 레벨 업

익숙해지면 Sherlock 또는 Maigret으로 사용자명 검색을 시도해보세요:

"사용자명 'johndoe123'을 소셜 미디어 플랫폼에서 검색해줘"

복잡한 오케스트레이션

여기서부터 흥미로워집니다. 도구를 연쇄적으로 사용할 수 있습니다:

"[email protected] 이메일을 찾았어. 다음을 할 수 있어?
1. 이 이메일이 등록된 플랫폼을 확인
2. 도메인을 추출하고 서브도메인과 다른 이메일 검색
3. 이 도메인과 관련된 사용자명 검색"

AI가 똑똑하게 하도록 두기

때로는 Claude에게 맥락을 제공하고 스스로 결정하게 하는 것이 최선의 방법입니다:

"사용자명 'hackerman2024'의 디지털 발자국을 조사하고 있어.
가능한 한 많은 정보를 수집하기 위해 너의 판단을 사용해줘."

프로 팁 🎯

SpiderFoot에는 인내심을: 매우 철저하지만 전체 검사에 최대 30분이 소요될 수 있습니다. 시작하고 커피 한 잔 하세요!
병렬 처리: Claude는 여러 도구를 동시에 실행할 수 있습니다. 병렬 검색을 요청하는 것을 망설이지 마세요:
```
"Sherlock과 Maigret에서 동시에 'johndoe'를 검색해줘"
```
통제 시점을 알기:
- 특정 조사: 사용할 도구를 명확히 지정
- 탐색적 연구: Claude가 도구를 선택하도록 하기
- 시간이 중요한 작업: SpiderFoot는 피하고 빠른 도구 사용
결과를 교차 검증: 서로 다른 도구는 서로 다른 데이터베이스를 가지고 있습니다. Maigret는 Sherlock이 놓친 계정을 찾을 수 있고 그 반대도 마찬가지입니다.
이메일 우선, 사용자명 나중: 이메일이 있다면 그곳부터 시작하세요. 일반적으로 사용자명보다 더 고유합니다.

⚖️ 윤리적 사용 및 법적 준수

🚨 중요: 이 도구는 합법적인 보안 연구 및 OSINT 조사 전용입니다.

반드시 지켜야 할 사항:

✅ 공개적으로 이용 가능한 정보만 수집
✅ 관할 구역의 개인정보 보호법(GDPR, CCPA 등) 준수
✅ 플랫폼의 서비스 약관 준수
✅ 결과를 책임감 있고 윤리적으로 사용
✅ 전문적인 조사를 위해 적절한 승인을 받을 것

절대 하지 말아야 할 사항:

❌ 스토킹, 괴롭힘 또는 악의적인 목적으로 사용
❌ 지역, 주 또는 연방법 위반
❌ 비공개 또는 보호된 정보에 접근
❌ 결과를 사용하여 개인이나 조직에 해를 끼침

🔧 문제 해결

일반적인 문제

도구를 찾을 수 없음: 모든 OSINT 도구가 설치되어 있고 PATH에 있는지 확인하세요:

which sherlock holehe maigret theharvester

SpiderFoot 오류: SpiderFoot가 /opt/spiderfoot에 설치되어 있는지 확인하거나 코드에서 경로를 업데이트하세요.

시간 초과 문제: 느린 연결에서는 일부 도구가 시간 초과될 수 있습니다. 시간 제한 매개변수를 늘려보세요:

"30초 시간 제한으로 사용자명 검색해줘"

속도 제한: 일부 플랫폼은 검색 속도를 제한합니다. 차단되면 잠시 기다렸다가 다시 시도하세요.

🏗️ 아키텍처

이 MCP 서버는 비차단 도구 실행을 위해 Python의 asyncio를 사용합니다. 각 도구는 서브프로세스로 실행되어 병렬 실행과 적절한 시간 초과 처리가 가능합니다.

Claude Desktop <-> MCP 프로토콜 <-> OSINT MCP 서버 <-> OSINT 도구

🤝 기여하기

버그를 발견했거나 새 도구를 추가하고 싶으신가요? 기여는 환영합니다!

저장소를 포크하세요
기능 브랜치를 만드세요 (git checkout -b feature/NewOSINTTool)
변경 사항을 커밋하세요 (git commit -m 'NewOSINTTool 지원 추가')
브랜치에 푸시하세요 (git push origin feature/NewOSINTTool)
풀 리퀘스트를 열어주세요

📚 감사의 말

다음 멋진 프로젝트에 특별히 감사드립니다:

mcp-maigret - MCP 구현 및 README 구조에 영감을 주었습니다. ⭐를 눌러주세요!
Model Context Protocol - 이 모든 것을 가능하게 한 프로토콜
모든 훌륭한 OSINT 도구 유지 관리자 분들

📜 라이선스

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

⚠️ 면책 조항

이 도구는 교육 및 합법적인 보안 연구 목적으로만 제공됩니다. 저자는 이 프로그램의 오용이나 손해에 대해 책임을 지지 않습니다. 사용에 따른 책임은 본인에게 있으며, 조사를 수행하기 전에 항상 적절한 승인을 받았는지 확인하세요.

기억하세요: 큰 힘에는 큰 책임이 따릅니다. 이 도구를 현명하고 윤리적으로 사용하세요! 🦸‍♂️

OSINT 커뮤니티를 위해 ❤️로 제작되었습니다.

osint-tools-mcp-server

인기