ESTE PROYECTO ESTÁ HECHO POR LLM

Tor Web MCP

Servidor MCP local para LM Studio con dos herramientas:

• tor_search(query, max_results=8) — busca en los servicios onion indexados de Ahmia.

• tor_fetch(url, max_chars=30000) — obtiene una URL .onion v3 a través de un proxy SOCKS5 de Tor local.

Instalación

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

Establece TOR_SOCKS_URL si tu listener SOCKS de Tor no está en 127.0.0.1:9050. Tor Browser suele usar un puerto diferente, así que verifica tu configuración.

Related MCP server: minimal-mcp-web-search

Prueba

mcp dev server.py

LM Studio

Configura un servidor MCP local stdio usando rutas absolutas:

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

Semántica de errores

El fetcher devuelve deliberadamente categorías de error legibles por LLM. En particular, un resultado de búsqueda que ya no es accesible se convierte en:

[SEARCH_RESULT_STALE]

Esto significa que la URL estaba indexada pero actualmente es inaccesible; no prueba que la dirección sea inválida. El modelo puede entonces probar con otro resultado de búsqueda.

Otras categorías incluyen INVALID_ONION_URL, TOR_SEARCH_TIMEOUT, TOR_SEARCH_HTTP_ERROR, TOR_SEARCH_NETWORK_ERROR, NO_RESULTS, TOR_FETCH_NETWORK_ERROR, TOR_REDIRECT y TOR_REDIRECT_BLOCKED.

Límites de seguridad

• Solo se aceptan URLs .onion v3 HTTP/HTTPS en tor_fetch.

• Sin redirecciones automáticas fuera de .onion.

• El tamaño de la respuesta y los tiempos de espera de red están limitados.

• No se expone ninguna herramienta proxy arbitraria genérica.

• El contenido devuelto por los servicios onion debe seguir tratándose como contenido web no confiable.