ЭТОТ ПРОЕКТ СДЕЛАН LLM

Tor Web MCP

Локальный MCP-сервер для LM Studio с двумя инструментами:

• tor_search(query, max_results=8) — ищет в onion-сервисах, индексируемых Ahmia.

• tor_fetch(url, max_chars=30000) — загружает v3 .onion URL через локальный SOCKS5-прокси Tor.

Установка

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

Установите TOR_SOCKS_URL, если ваш SOCKS-слушатель Tor не находится на 127.0.0.1:9050. Tor Browser обычно использует другой порт, поэтому проверьте вашу конфигурацию.

Related MCP server: minimal-mcp-web-search

Тест

mcp dev server.py

LM Studio

Настройте локальный stdio MCP-сервер, используя абсолютные пути:

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

Семантика ошибок

Загрузчик намеренно возвращает категории ошибок, читаемые LLM. В частности, результат поиска, который больше не доступен, становится:

[SEARCH_RESULT_STALE]

Это означает, что URL был проиндексирован, но в данный момент недоступен; это не доказывает, что адрес недействителен. Затем модель может попробовать другой результат поиска.

Другие категории включают INVALID_ONION_URL, TOR_SEARCH_TIMEOUT, TOR_SEARCH_HTTP_ERROR, TOR_SEARCH_NETWORK_ERROR, NO_RESULTS, TOR_FETCH_NETWORK_ERROR, TOR_REDIRECT и TOR_REDIRECT_BLOCKED.

Границы безопасности

• tor_fetch принимает только HTTP/HTTPS v3 .onion URL-адреса.

• Нет автоматических перенаправлений за пределы .onion.

• Размер ответа и сетевые таймауты ограничены.

• Не предоставляется универсальный произвольный прокси-инструмент.

• Контент, возвращаемый onion-сервисами, по-прежнему должен рассматриваться как недоверенный веб-контент.