이 프로젝트는 LLM에 의해 만들어졌습니다

Tor Web MCP

LM Studio용 로컬 MCP 서버로, 두 가지 도구가 있습니다:

• tor_search(query, max_results=8) — Ahmia가 색인한 onion 서비스를 검색합니다.

• tor_fetch(url, max_chars=30000) — 로컬 Tor SOCKS5 프록시를 통해 v3 .onion URL을 가져옵니다.

설치

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

Tor SOCKS 리스너가 127.0.0.1:9050이 아닌 경우 TOR_SOCKS_URL을 설정하세요. Tor 브라우저는 일반적으로 다른 포트를 사용하므로 설정을 확인하세요.

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 서비스에서 반환된 콘텐츠는 여전히 신뢰할 수 없는 웹 콘텐츠로 취급해야 합니다.