このプロジェクトはLLMによって作られています

Tor Web MCP

LM Studio向けのローカルMCPサーバーで、2つのツールを備えています:

• tor_search(query, max_results=8) — Ahmiaがインデックスしたオニオンサービスを検索します。

• 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 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の外部への自動リダイレクトはありません。

• レスポンスサイズとネットワークタイムアウトには上限があります。

• 汎用的な任意のプロキシツールは公開されていません。

• オニオンサービスが返すコンテンツは、依然として信頼できないWebコンテンツとして扱う必要があります。