🔍 OSINT Tools MCP Server

Ein umfassender MCP-Server, der KI-Assistenten wie Claude mehrere OSINT-Tools bereitstellt. Dieser Server ermöglicht es der KI, anspruchsvolle Aufklärungs- und Informationssammlungsaufgaben mit branchenüblichen OSINT-Tools durchzuführen.

🛠️ Verfügbare Tools

🔍 Sherlock – Benutzernamensuche

Durchsucht Benutzernamen auf 399+ Social-Media-Plattformen und Websites. Perfekt für die Analyse digitaler Fußabdrücke.

• Eingabe: Benutzername
• Ausgabe: Liste der Plattformen, auf denen der Benutzername vorhanden ist

📧 Holehe – E-Mail-Verifizierung

Prüft, ob eine E-Mail auf 120+ Plattformen registriert ist. Blitzschnell und präzise.

• Eingabe: E-Mail-Adresse
• Ausgabe: Plattformen, auf denen die E-Mail registriert ist

🕷️ SpiderFoot – Umfassendes OSINT

Das Schweizer Taschenmesser des OSINT. Führt tiefgehende Aufklärung mit automatischer Erkennung des Zieltyps durch.

• Eingabe: IP, Domain, E-Mail, Telefon, Benutzername, Personenname, Bitcoin-Adresse oder Netzwerkblock
• Ausgabe: Umfassender Intelligence-Bericht
• ⚠️ Hinweis: SpiderFoot kann 5–30 Minuten benötigen, um einen vollständigen Scan abzuschließen. Sei geduldig!

🔎 GHunt – Google-Konto-Intel

Extrahiert Informationen aus Google-Konten mithilfe von E-Mail oder Google-ID.

• Eingabe: E-Mail oder Google-ID
• Ausgabe: Details zum Google-Konto und zugehörige Informationen

🌐 Maigret – Erweiterte Benutzernamensuche

Durchsucht über 3000+ Websites mit Erkennung falscher Treffer und detaillierter Analyse.

• Eingabe: Benutzername
• Ausgabe: Detaillierter Bericht mit Konfidenzwerten

🌾 TheHarvester – Domain-Intelligence

Sammelt E-Mails, Subdomains, Hosts, Mitarbeiternamen und mehr aus öffentlichen Quellen.

• Eingabe: Domain oder Firmenname
• Ausgabe: Umfassende Domain-Intelligence

🐦 Blackbird – Schnelles Benutzername-OSINT

Blitzschnelle Suchen auf 581 Websites für die Benutzernamen-Aufklärung.

• Eingabe: Benutzername
• Ausgabe: Schnelle Profil-Erkennungsergebnisse

🚀 Installation

MCP-Server-Einrichtung

1. Dieses Repository klonen:

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

2. Abhängigkeiten installieren:

pip install -r requirements.txt

Dadurch werden automatisch Sherlock, Holehe, Maigret und TheHarvester installiert.

3. Claude Desktop konfigurieren:

Füge Folgendes zu deiner Claude-Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

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

4. Starte Claude Desktop neu, um den neuen MCP-Server zu laden.

Voraussetzungen für zusätzliche Tools

Einige Tools erfordern aufgrund ihrer Komplexität eine manuelle Installation:

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

🎮 Nutzungstipps

Erste Schritte

Die Arbeit mit KI für OSINT ist eine Kunst für sich. So erzielst du die besten Ergebnisse:

Fang einfach mit Holehe an

Ich empfehle, mit dem Holehe-Tool zu beginnen – es ist schnell, zuverlässig und liefert sofortige Ergebnisse:

"Prüfe, ob [email protected] auf irgendwelchen Plattformen registriert ist"

Nächste Stufe: Benutzernamensuchen

Sobald du dich sicher fühlst, probiere Benutzernamensuchen mit Sherlock oder Maigret aus:

"Suche auf Social-Media-Plattformen nach dem Benutzernamen 'johndoe123'"

Komplexe Orchestrierungen

Hier wird es interessant. Du kannst Tools miteinander verketten:

"Ich habe eine E-Mail-Adresse [email protected] gefunden. Kannst du:
1. Prüfen, auf welchen Plattformen sie registriert ist
2. Die Domain extrahieren und nach Subdomains und anderen E-Mails suchen
3. Nach Benutzernamen suchen, die mit dieser Domain verknüpft sind"

Lass die KI schlau sein

Manchmal ist der beste Ansatz, Claude Kontext zu geben und es entscheiden zu lassen:

"Ich untersuche den digitalen Fußabdruck des Benutzernamens 'hackerman2024'.
Nutze dein Urteilsvermögen, um so viele Informationen wie möglich zu sammeln."

Profi-Tipps 🎯

1. Sei geduldig mit SpiderFoot: Es ist unglaublich gründlich, aber ein vollständiger Scan kann bis zu 30 Minuten dauern. Starte es und hol dir einen Kaffee!

2. Parallele Verarbeitung: Claude kann mehrere Tools gleichzeitig ausführen. Zögere nicht, parallele Suchen anzufordern:

   "Suche gleichzeitig nach 'johndoe' auf Sherlock und Maigret"
   

3. Wisse, wann du die Zügel in der Hand halten solltest:

   • Bei gezielten Untersuchungen: Sei explizit, welche Tools verwendet werden sollen
   • Bei explorativer Recherche: Lass Claude die Tools wählen
   • Bei zeitkritischen Aufgaben: Vermeide SpiderFoot und nutze schnellere Tools

4. Ergebnisse abgleichen: Verschiedene Tools haben unterschiedliche Datenbanken. Maigret findet möglicherweise Konten, die Sherlock übersieht, und umgekehrt.

5. Erst E-Mail, dann Benutzername: Wenn du eine E-Mail hast, beginne damit – sie ist normalerweise eindeutiger als Benutzernamen.

⚖️ Ethische Nutzung & rechtliche Konformität

🚨 WICHTIG: Dieses Tool ist ausschließlich für legitime Sicherheitsforschung und OSINT-Untersuchungen gedacht.

Du MUSST:

• ✅ Nur öffentlich verfügbare Informationen sammeln
• ✅ Datenschutzgesetze in deiner Rechtsordnung respektieren (DSGVO, CCPA usw.)
• ✅ Die Nutzungsbedingungen der Plattformen einhalten
• ✅ Erkenntnisse verantwortungsvoll und ethisch nutzen
• ✅ Für berufliche Untersuchungen eine ordnungsgemäße Genehmigung einholen

Du DARFST NICHT:

• ❌ Dies für Stalking, Belästigung oder böswillige Zwecke nutzen
• ❌ Gegen lokale, staatliche oder bundesstaatliche Gesetze verstoßen
• ❌ Auf private oder geschützte Informationen zugreifen
• ❌ Erkenntnisse nutzen, um Einzelpersonen oder Organisationen zu schaden

🔧 Fehlerbehebung

Häufige Probleme

Tools nicht gefunden: Stelle sicher, dass alle OSINT-Tools installiert und in deinem PATH sind:

which sherlock holehe maigret theharvester

SpiderFoot-Fehler: Stelle sicher, dass SpiderFoot in /opt/spiderfoot installiert ist, oder aktualisiere den Pfad im Code.

Timeout-Probleme: Bei langsamen Verbindungen können bei einigen Tools Timeouts auftreten. Versuche, den Timeout-Parameter zu erhöhen:

"Suche nach Benutzername mit einem 30-Sekunden-Timeout"

Ratenbegrenzung: Einige Plattformen begrenzen die Anzahl der Suchen. Wenn du blockiert wirst, warte einen Moment und versuche es erneut.

🏗️ Architektur

Dieser MCP-Server nutzt Pythons asyncio für eine nicht-blockierende Tool-Ausführung. Jedes Tool läuft in einem Unterprozess, was eine parallele Ausführung und eine ordnungsgemäße Timeout-Behandlung ermöglicht.

Claude Desktop <-> MCP Protocol <-> OSINT MCP Server <-> OSINT Tools

🤝 Mitwirken

Einen Fehler gefunden? Du möchtest ein neues Tool hinzufügen? Beiträge sind willkommen!