English Français العربية

io.github.litportnet/free-proxy-mcp

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @litportnet/free-proxy-mcp
Claude Code 
claude mcp add free-proxy-mcp -- npx -y @litportnet/free-proxy-mcp@0.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "free-proxy-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@litportnet/free-proxy-mcp@0.1.0"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Litport Free Proxy MCP Server
  2. Install / Use with Claude Desktop, Claude Code, and other MCP clients
  3. Tools
  4. Environment
  5. Test
  6. Resources

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):

{
  "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:

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

npm install
npm 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.

الأسئلة الشائعة

ما هو io.github.litportnet/free-proxy-mcp؟

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

كيف أثبّت io.github.litportnet/free-proxy-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add free-proxy-mcp -- npx -y @litportnet/free-proxy-mcp@0.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.litportnet/free-proxy-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.litportnet/free-proxy-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.litportnet/free-proxy-mcp؟

ينشره litportnet. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.