Maigret MCP Server

maigret için bir Model Context Protocol (MCP) sunucusu. Maigret, çeşitli açık kaynaklardan kullanıcı hesap bilgilerini toplayan güçlü bir OSINT aracıdır. Bu sunucu, kullanıcı adlarını sosyal ağlar arasında aramak ve URL'leri analiz etmek için araçlar sağlar. Claude Desktop gibi MCP uyumlu uygulamalarla sorunsuz entegrasyon için tasarlanmıştır.

⚠️ Uyarı

Bu araç, meşru OSINT araştırması amaçları için tasarlanmıştır. Lütfen:

• Yalnızca genel olarak erişilebilir bilgileri arayın
• Gizliliğe ve veri koruma yasalarına saygı gösterin
• Aranan platformların hizmet şartlarına uyun
• Sorumlu ve etik şekilde kullanın
• Bazı sitelerin otomatik aramaları sınırlandırabileceğini veya engelleyebileceğini unutmayın

Güvenlik

Bu sunucu, komut enjeksiyonu saldırılarını önlemek için birkaç güvenlik önlemi uygulamaktadır:

Giriş Doğrulaması

• Kullanıcı adları: Yalnızca alfanümerik karakterler, alt çizgiler, tireler ve noktalar izin verilir (maksimum 100 karakter)
• URL'ler: Geçerli HTTP/HTTPS URL'leri olmalı ve shell meta karakterleri içermemelidir
• Etiketler: Yalnızca alfanümerik karakterler, alt çizgiler ve tireler izin verilir

Güvenli Komut Yürütme

• Shell interpolasyonunu önlemek için execFile() yerine exec() kullanır
• Tüm komut argümanları dizi olarak iletilir, birleştirilmiş dizeler değil
• Docker komutları shell yorumu olmadan yürütülür

Güvenlik Sorunlarını Bildirme

Bir güvenlik açığı keşfederseniz, lütfen bir issue açarak veya maintainer'larla doğrudan iletişime geçerek bildirin. Güvenliği ciddiye alıyoruz ve hızlı bir şekilde yanıt vereceğiz.

Gereksinimler

• Node.js (v18 veya sonrası)
• Docker
• Docker Desktop yüklü macOS, Linux veya Windows
• Reports dizinine yazma erişimi

Hızlı Başlangıç

Smithery Aracılığıyla Kurulum

Maigret'i Claude Desktop için Smithery aracılığıyla otomatik olarak kurmak için:

npx -y @smithery/cli install mcp-maigret --client claude

Manuel Kurulum

1. Docker'ı yükleyin:

   • macOS: Docker Desktop yükleyin
   • Linux: Docker Engine kurulum kılavuzunu izleyin

2. Sunucuyu npm aracılığıyla global olarak yükleyin:

npm install -g mcp-maigret

3. Bir reports dizini oluşturun:

mkdir -p /path/to/reports/directory

4. Claude Desktop yapılandırma dosyanıza ekleyin:

{
  "mcpServers": {
    "maigret": {
      "command": "mcp-maigret",
      "env": {
        "MAIGRET_REPORTS_DIR": "/path/to/reports/directory"
      }
    }
  }
}

Yapılandırma dosyası konumu:

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

5. Claude Desktop'ı yeniden başlatın

Alternatif Kurulum (Kaynaktan)

Kaynaktan çalıştırmayı tercih ediyorsanız veya kodu değiştirmeniz gerekiyorsa:

1. Klonlayın ve oluşturun:

git clone <repository_url>
cd mcp-maigret
npm install
npm run build

2. Claude Desktop yapılandırmanıza ekleyin:

{
  "mcpServers": {
    "maigret": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-maigret/build/index.js"],
      "env": {
        "MAIGRET_REPORTS_DIR": "/path/to/reports/directory"
      }
    }
  }
}

Özellikler

• Kullanıcı Adı Araması: Yüzlerce sosyal ağ ve websitesi arasında kullanıcı adı arayın
• URL Analizi: URL'leri ayrıştırarak bilgi çıkarın ve ilişkili kullanıcı adlarını arayın
• Birden Fazla Çıktı Formatı: txt, html, pdf, json, csv ve xmind formatları için destek
• Site Filtreleme: Aramaları site etiketlerine göre filtreleyin (örneğin, photo, dating, us)
• Docker Tabanlı: Ortamlar arasında güvenilir ve tutarlı yürütme

Araçlar

1. Kullanıcı Adı Araması Aracı

• Ad: search_username
• Açıklama: Sosyal ağlar ve siteler arasında kullanıcı adı arayın
• Parametreler:
  • username (zorunlu): Aranacak kullanıcı adı (alfanümerik, alt çizgiler, tireler, noktalar; maksimum 100 karakter)
  • format (isteğe bağlı, varsayılan: "pdf"): Çıktı formatı (txt, html, pdf, json, csv, xmind)
  • use_all_sites (isteğe bağlı, varsayılan: false): En iyi 500 yerine tüm kullanılabilir siteleri kullanın
  • tags (isteğe bağlı): Siteleri filtrelemek için etiketler dizisi (alfanümerik, alt çizgiler, tireler)

Örnek:

{
  "username": "test_user123",
  "format": "html",
  "use_all_sites": false,
  "tags": ["photo"]
}

2. URL Analizi Aracı

• Ad: parse_url
• Açıklama: URL'yi ayrıştırarak bilgi çıkarın ve ilişkili kullanıcı adlarını arayın
• Parametreler:
  • url (zorunlu): Analiz edilecek URL
  • format (isteğe bağlı, varsayılan: "pdf"): Çıktı formatı (txt, html, pdf, json, csv, xmind)

Örnek:

{
  "url": "https://example.com/profile",
  "format": "txt"
}

Sorun Giderme

Docker Sorunları

1. Docker'ın yüklü ve çalışır durumda olduğunu doğrulayın:

docker --version
docker ps

2. Docker izinlerini kontrol edin:
   • Kullanıcınızın Docker komutlarını çalıştırma izni olduğundan emin olun
   • Linux'ta, kullanıcınızı docker grubuna ekleyin: sudo usermod -aG docker $USER

Reports Dizini Sorunları

1. Reports dizinini doğrulayın:

   • MAIGRET_REPORTS_DIR'de belirtilen dizin mevcut olmalıdır
   • Kullanıcınızın bu dizine yazma izni olmalıdır
   • İzinleri kontrol edin: ls -la /path/to/reports/directory

2. Yaygın yapılandırma hataları:

   • Eksik MAIGRET_REPORTS_DIR ortam değişkeni
   • Dizin yok
   • Yanlış izinler
   • Yolda sondaki eğik çizgiler

3. Herhangi bir sorunu düzelttikten sonra:

   • Yapılandırma dosyasını kaydedin
   • Claude Desktop'ı yeniden başlatın

Hata Mesajları

• "Docker is not installed or not running": Docker'ı yükleyin ve Docker daemon'ını başlatın
• "MAIGRET_REPORTS_DIR environment variable must be set": Ortam değişkenini yapılandırmanıza ekleyin
• "Error creating reports directory": Dizin izinlerini ve yolunu kontrol edin
• "Error executing maigret": Docker günlüklerini kontrol edin ve konteyner'ın uygun izinleri olduğundan emin olun
• "Invalid username": Kullanıcı adı geçersiz karakterler içeriyor. Yalnızca alfanümerik, alt çizgiler, tireler ve noktaları kullanın
• "Invalid URL": URL yanlış biçimlendirilmiş veya yasak karakterler içeriyor
• "Invalid tag": Etiket geçersiz karakterler içeriyor. Yalnızca alfanümerik, alt çizgiler ve tirehleri kullanın

Katkıda Bulunma

1. Repoyu fork edin
2. Bir feature branch'i oluşturun (git checkout -b feature/amazing-feature)
3. Değişikliklerinizi commit edin (git commit -m 'Add amazing feature')
4. Branch'e push edin (git push origin feature/amazing-feature)
5. Pull Request açın

Lisans

Bu proje MIT Lisansı altında lisanslanmıştır - ayrıntılar için LICENSE dosyasına bakın.