Free Proxy Mcp

io.github.litportnet由 GitHub 帳號 litportnet 發布v0.1.0更新於 Oct 24, 2026

MCP server exposing Litport's verified free HTTP, SOCKS4 and SOCKS5 proxy snapshot.

已驗證STDIO僅桌面網頁搜尋與抓取開發者工具

概覽

AI 產生的概覽

本機 stdio MCP 伺服器，讓助理列出、排序並彙總 Litport 已驗證的免費 HTTP、SOCKS4 與 SOCKS5 代理快照。

可以做什麼
依協定、國家、匿名等級、HTTPS 支援、延遲、可用率、檢測次數與檢測時間篩選並列出已驗證的免費代理，結果數量 1 至 50（預設 10）。以相同篩選條件挑選排名最高的代理，回傳 1 至 25 筆（預設 5）。彙總目前快照：符合總數、依協定與匿名等級的計數、數量最多的前 10 個國家、HTTPS 佔比、延遲最小值/中位數/p90/最大值、已知七天可用率的涵蓋情況，以及最新與最舊的最後檢測時間。每個回應都帶有免責聲明欄位，SDK 錯誤會以錯誤結果回傳，而不是拋出例外。
適用情境
當你需要用於測試或研究的候選免費代理，並希望助理依協定、國家、延遲或可用率篩選與排序，而不必手動瀏覽清單時適用。它只是唯讀查詢層，不是代理用戶端，不會轉送任何流量。
執行需求
透過 stdio 在本機執行，需要 Node.js 20 或更新版本，npx 可隨需取得並執行該套件。需要能存取快照端點的網路。選用環境變數 LITPORT_FREE_PROXY_API_URL（必須是絕對的 http 或 https URL）與 LITPORT_FREE_PROXY_TIMEOUT_MS（預設 10000）可調整端點與逾時。未宣告任何身分驗證。
安裝前請注意
免費代理僅供測試使用，切勿透過它們傳輸憑證、Cookie、付款資料或隱私資料。伺服器本身唯讀且不轉送流量，但它回傳的代理記錄指向信任度未知的第三方主機。設定 LITPORT_FREE_PROXY_API_URL 會把快照取得重新導向到其他端點，請只指向你信任的來源。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Free Proxy Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[Litport free proxies: live lists, API and SDKs]

Litport Free Proxy MCP Server

A local, stdio Model Context Protocol server that gives an MCP client (Claude Desktop, Claude Code, or any other MCP-compatible agent) three bounded, read-only tools over Litport's public free-proxy snapshot: list verified HTTP, SOCKS4, and SOCKS5 proxies, pick the highest-ranked ones, and summarize the current snapshot. It never forwards traffic, never accepts arbitrary URLs from tool callers, and exposes no write or side-effecting tools; it is a thin wrapper around @litportnet/free-proxy-sdk.

Install / Use with Claude Desktop, Claude Code, and other MCP clients

Add this to your client's MCP server configuration (for Claude Desktop, claude_desktop_config.json; for Claude Code, .mcp.json or claude mcp add):

json
{  "mcpServers": {    "free-proxy": {      "command": "npx",      "args": ["-y", "@litportnet/free-proxy-mcp"]    }  }}

No installation step is required beyond having Node.js 20+ available; npx fetches and runs the package on demand. To install it explicitly instead:

sh
npm install -g @litportnet/free-proxy-mcp

Tools

All three tools are read-only and share the same underlying filters. country is a two-letter ISO 3166-1 alpha-2 code (case-insensitive). checkedWithinMin limits results to proxies checked within the last 1-1440 minutes.

ToolDescriptionInputs
list_proxiesList verified free proxies matching filters.protocol (http|socks4|socks5), country, anonymity (transparent|anonymous|elite|unknown), https (boolean), maxLatencyMs (int ≥ 0), minUptime7d (int 0-100), minChecks7d (int ≥ 0), checkedWithinMin (int 1-1440, default 30), limit (int 1-50, default 10)
pick_best_proxiesReturn the highest-ranked proxies matching filters.count (int 1-25, default 5), plus the same filters as list_proxies except limit
proxy_snapshot_statsSummarize the current proxy snapshot.checkedWithinMin (int 1-1440, default 30), protocol, country

list_proxies and pick_best_proxies return a count and a proxies array of normalized records exactly as returned by the SDK. proxy_snapshot_stats returns the total matching count, counts by protocol and anonymity, the top 10 countries by count, the share of matching proxies that support HTTPS, latency min/median/p90/max across records that report latency, how many records have a known seven-day uptime, and the newest and oldest lastChecked timestamps. Every response includes a disclaimer field. Errors from the underlying SDK (invalid filters, request timeouts, malformed or stale snapshots) are returned as { isError: true, content: [...] } rather than thrown, and never include a stack trace.

Environment

VariableDefaultPurpose
LITPORT_FREE_PROXY_API_URLthe SDK's built-in snapshot URLAbsolute http:// or https:// URL for the snapshot endpoint. The server validates this and exits with a clear error on startup if it is set to something else.
LITPORT_FREE_PROXY_TIMEOUT_MS10000Per-request timeout in milliseconds passed to the SDK client.

Test

sh
npm installnpm test

npm test runs node --test over test/*.test.mjs: in-process unit tests that drive the server through the MCP SDK's in-memory transport with an injected @litportnet/free-proxy-sdk client, and an end-to-end test that spawns the server over stdio against a local HTTP fixture server, plus a regression test that launches the server through a bin symlink the way npx does.

Resources

Free proxies are for testing only. Never route credentials, cookies, payment data, or private data through them.

來源：README.md，提交 2e5cd5c

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 17, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分