tor-mcp

tor-mcp

.onion / dark web araştırması için bir MCP sunucusu. Yetkili tehdit istihbaratı,kırmızı takım ve güvenlik araştırması içindir.

Bu sunucu işi sıfırdan yapmaz. OpenTor skill'inin motorunuModel Context Protocol üzerinden dışarı açar. MCP açık bir protokol olduğu içinsunucu model bağımsızdır: Cursor, VS Code, Zed, Cline, Continue, OpenAI Agents SDK,LangChain gibi MCP konuşan her istemci ve tool-calling yapabilen her modelkullanabilir.

Neden sarmalayıcı, neden kopya değil: motor kodunda reklam filtreleme, diferansiyelkalibrasyon, ayna birleştirme ve açıklanabilir sıralama gibi kırılgan bilgi birikmiş.İkinci bir kopya tutmak iki ayrı yerde bakım yapmak demek olurdu.

Gereksinimler

Sunucu, skill'in .env dosyasındaki TOR_SOCKS_PORT ayarını kullanır.

• 9050: bağımsız tor.exe veya Tor Expert Bundle
• 9150: Tor Browser (açık kalmalı)

OPENTOR_SKILL_ROOT ortam değişkenini OpenTor motorunun bulunduğu klasöre ayarla.

Kurulum

git clone https://github.com/ilkerK01/tor-mcp.git
cd tor-mcp
python -m venv .venv

Linux / macOS:

.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python selftest.py

Windows:

.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe selftest.py

ALL CHECKS PASSED görmelisin. Tor kapalıysa ağ tool'ları atlanır, geri kalanher şey yine test edilir.

İstemciye bağlama

Aşağıdaki yollarda /path/to/tor-mcp kısmını kendi klasörünle değiştir.

Elle JSON (Cursor, Zed, Cline, VS Code vb.)

{
  "mcpServers": {
    "tor-mcp": {
      "command": "/path/to/tor-mcp/.venv/bin/python",
      "args": ["/path/to/tor-mcp/server.py"]
    }
  }
}

Windows'ta command alanı C:\\path\\to\\tor-mcp\\.venv\\Scripts\\python.exe olur.

Windows yol notu: Kullanıcı adında ASCII dışı karakter varsa (ör. Türkçeİ, ş, ğ) UTF-8 okumayan araçlar yolu bozup süreci dosyayı bulamadanöldürebilir. Bu durumda dir /x ile 8.3 kısa yolunu öğrenip onu kullan.

Tool'lar (14)

Bağlantı

Arama

Çekme

Analiz

Soruşturma

Analiz modları

onion_search, plan_queries ve investigate bir mode parametresi alır. Mod,hangi motorların kullanılacağını ve sorguların nasıl genişletileceğini belirler.

• threat_intel: genel tehdit istihbaratı, tüm motorlar
• ransomware: fidye yazılımı sızıntı siteleri, bilinen tohum adresler dahil
• personal_identity: kimlik ve kimlik bilgisi sızıntısı
• corporate: kurumsal maruziyet

Tipik akış

1. tor_status                     bağlantıyı doğrula
2. engine_health                  kaç motor ayakta (az sonuç gelirse sebebi budur)
3. plan_queries(hedef, mode)      sorgu setini gör
4. onion_search(sorgu, mode)      sonuçları topla
5. triage_results(sonuclar)       ölü adresleri ele
6. onion_batch_fetch(canli_urls)  içerikleri çek
7. extract_iocs(metin)            IOC çıkar
8. export_findings(..., "misp")   platforma teslim et

Kestirme yol: investigate(hedef, mode) 3 ile 7 arasını tek çağrıda yapar.

Dikkat edilecekler

Süre. Tor üzerinden her istek 30 ile 60 saniye sürer. onion_search motorlarıparalel sorgular ama yine de bir dakikayı bulabilir. investigate varsayılan olarak240 saniyelik sert bir bütçeyle çalışır, çünkü çoğu MCP istemcisinin zaman aşımıbunun üstündedir. Bütçe dolunca kısmi dosya döner, hiçbir şey kaybolmaz.

Ölü adresler normaldir. Sızıntı siteleri sürekli adres değiştirir.triage_results tam olarak bunun için var.

Sonuç azsa önce motorları kontrol et. .onion arama motorlarının yarısınınaynı anda kapalı olması olağandır. "Bu konuda hiçbir şey yok" demeden önceengine_health çalıştır.

Tokenizasyon önemli. Motorlar niyeti değil token'ı indeksler. Bitişik, boşlukluve tireli formlar farklı sonuç verir. Bir şeyin indekste olmadığına karar vermedenönce üçünü de dene.

Gözlem yorum değildir. investigate bir dosya döner, hüküm vermez. Birsızıntının gerçek mi yoksa yeniden satılan eski bir dump mı olduğuna karar vermekçağıranın işidir.

Kapsam. Yetkili tehdit istihbaratı, kırmızı takım ve güvenlik araştırmasıiçindir. Sunucu yasa dışı içeriği filtreler ama asıl sınırı kullanan çizer.

Sorun giderme

Dosyalar

tor-mcp/
├── server.py         MCP sunucusu, 14 tool
├── selftest.py       Tor'suz çalışan doğrulama testi
├── requirements.txt
├── LICENSE
└── README.md

Veritabanı ve bulgu defteri skill ile ortaktır (<skill>/database/opentor.db).Yani MCP üzerinden yaptığın araştırma, skill üzerinden yaptığınla aynı hafızayıpaylaşır. Bu dosya repoya dahil değildir.

Lisans

MIT. Ayrıntı için LICENSE dosyasına bak.