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 分