w0h1v/mcp-maigret

퀵스타트 · 도구 · 포맷 · 보안 · 문제 해결 · 문서

mcp-maigret는 AI 에이전트가 수천 개 사이트에서 사용자 이름을 확인하는 OSINT 도구인 maigret를 실행할 수 있게 하는 MCP 서버입니다. 에이전트에게 핸들이 등록된 위치를 찾거나 프로필 URL을 분석해 달라고 요청하고, 저장된 보고서를 받아보세요. Maigret는 Docker에서 실행되므로 Docker와 Node 외에는 설치할 것이 없습니다.

[! 경고] 공개된 정보에 대한 합법적이고 허가된 OSINT 연구에 이 기능을 사용합니다. 법과 각 사이트의 서비스 약관을 준수하고, 개인의 프라이버시를 존중하세요. 일부 사이트는 자동 조회를 제한하거나 차단합니다.

하이라이트

• 수백에서 수천 개 사이트에 걸친 사용자 이름 검색, 태그별 필터링 가능(photo, dating, us 등).
• URL 분석. 프로필 URL을 건네주면 Maigret가 가능한 것을 추출해 연결된 사용자 이름을 찾습니다.
• 여섯 가지 보고서 형식 (txt, html, csv, json, xmind, pdf), 원하는 디렉터리에 저장됩니다. 오늘 어떤 것이 정상인지 확인해 보세요.
• 강화된 입력. 인수 배열을 포함한 엄격한 검증과 execFile. 셸은 절대 개입되지 않습니다. 보안을 참조하세요.
• **도커 기반입니다.

Quickstart · Tools · Formats · Security · Troubleshooting · Docs

mcp-maigret is an MCP server that lets AI agents run maigret, the OSINT tool that checks a username across thousands of sites. Ask your agent to find where a handle is registered, or to analyze a profile URL, and get a saved report back. Maigret runs in Docker, so there is nothing to install besides Docker and Node.

[!WARNING] Use this for legitimate, authorized OSINT research on publicly available information. Follow the law and each site’s terms of service, and respect people’s privacy. Some sites rate-limit or block automated lookups.

Highlights

• Username search across hundreds to thousands of sites, filterable by tag (photo, dating, us, …).
• URL analysis. Hand it a profile URL and maigret extracts what it can and looks for linked usernames.
• Six report formats (txt, html, csv, json, xmind, pdf), saved to a directory you choose. See which ones work today.
• Hardened inputs. Strict validation and execFile with argument arrays. No shell is ever involved. See Security.
• Docker-based. The maigret image is pulled on first use, so every machine runs the same maigret.

How it works

flowchart LR
    A["AI agent(Claude Desktop, Claude Code, any MCP client)"] -->|"MCP over stdio"| S["mcp-maigret"]
    S -->|"validate input,execFile docker run"| D["soxoj/maigret(Docker)"]
    D -->|"checks sites"| W(("Publicwebsites"))
    D -->|"writes report"| R[("MAIGRET_REPORTS_DIR")]
    S -->|"report path + scan output"| A

Quickstart