DIESES PROJEKT WURDE VON LLM ERSTELLT

Tor Web MCP

Lokaler MCP-Server für LM Studio mit zwei Tools:

• tor_search(query, max_results=8) — durchsucht Ahmias indizierte Onion-Dienste.

• tor_fetch(url, max_chars=30000) — ruft eine v3-.onion-URL über einen lokalen Tor-SOCKS5-Proxy ab.

Installation

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Setzen Sie TOR_SOCKS_URL, wenn Ihr Tor-SOCKS-Listener nicht auf 127.0.0.1:9050 lauscht. Tor Browser verwendet üblicherweise einen anderen Port. Überprüfen Sie daher Ihre Konfiguration.

Related MCP server: minimal-mcp-web-search

Test

mcp dev server.py

LM Studio

Konfigurieren Sie einen lokalen stdio-MCP-Server mit absoluten Pfaden:

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

Fehlersemantik

Der Fetcher gibt bewusst LLM-lesbare Fehlerkategorien zurück. Insbesondere wird ein Suchergebnis, das nicht mehr erreichbar ist, zu:

[SEARCH_RESULT_STALE]

Das bedeutet, dass die URL indiziert wurde, aber derzeit nicht erreichbar ist; es beweist nicht, dass die Adresse ungültig ist. Das Modell kann dann ein anderes Suchergebnis ausprobieren.

Weitere Kategorien sind INVALID_ONION_URL, TOR_SEARCH_TIMEOUT, TOR_SEARCH_HTTP_ERROR, TOR_SEARCH_NETWORK_ERROR, NO_RESULTS, TOR_FETCH_NETWORK_ERROR, TOR_REDIRECT und TOR_REDIRECT_BLOCKED.

Sicherheitsgrenzen

• Nur HTTP/HTTPS-v3-.onion-URLs werden von tor_fetch akzeptiert.

• Keine automatischen Weiterleitungen außerhalb von .onion.

• Antwortgröße und Netzwerk-Timeouts sind begrenzt.

• Es wird kein generisches Proxy-Tool für beliebige Zwecke bereitgestellt.

• Inhalte, die von Onion-Diensten zurückgegeben werden, müssen weiterhin als nicht vertrauenswürdige Webinhalte behandelt werden.