用途
free-proxy-mcp 是一个本地、基于 stdio 的 Model Context Protocol（MCP）服务器，用于向 MCP 客户端（例如 Claude Desktop、Claude Code 或其他兼容 MCP 的智能体）提供 Litport 公共免费代理快照的访问能力。它提供三个受限的只读工具，用于列出经核验的 HTTP、SOCKS4 和 SOCKS5 代理、挑选排名最高的代理，以及汇总当前快照信息。
主要能力
该服务器是围绕 @litportnet/free-proxy-sdk 的轻量封装，暴露三类只读工具，并共享同一套底层筛选条件：
- list_proxies：列出代理。
- pick_best_proxies：挑选排名最高的代理。
- proxy_snapshot_stats：汇总统计。
筛选参数包括：
- country：两位 ISO 3166-1 alpha-2 国家代码，大小写不敏感。
- checkedWithinMin：将结果限制为最近 1 至 1440 分钟内检查过的代理。
list_proxies 和 pick_best_proxies 返回一个 count 和一个 proxies 数组，数组内为 SDK 原样返回的规范化记录。proxy_snapshot_stats 返回：匹配总数、按协议与匿名性的计数、按数量排名前 10 的国家、匹配代理中支持 HTTPS 的比例、在报告延迟的记录中延迟的最小值/中位数/p90/最大值、具有已知七天在线率的记录数量，以及最新与最旧的 lastChecked 时间戳。每个响应都包含一个 disclaimer 字段。
使用方式
在客户端的 MCP 服务器配置中添加此服务器即可。对于 Claude Desktop，配置 claude_desktop_config.json；对于 Claude Code，可使用 .mcp.json 或 claude mcp add。除需要 Node.js 20+ 外，无需额外安装步骤，npx 会按需获取并运行该包。如需显式安装也可以自行安装。
适用场景
适用于需要以只读方式获取经核验免费代理列表、筛选特定国家或时效范围的代理、或了解当前快照统计信息的 MCP 客户端与智能体场景。
限制与安全声明
该服务器从不转发流量，从不接受工具调用方传入的任意 URL，也不暴露任何写入或产生副作用的工具。所有工具均为只读。底层 SDK 的错误（无效筛选、请求超时、格式错误或过期的快照）会以 { isError: true, content: [...] } 形式返回，而非抛出异常，并且不包含堆栈跟踪。免费代理仅供测试使用，切勿通过它们传输凭据、Cookie、支付数据或隐私数据。相关 API 文档与免费代理列表可通过官方渠道获取。
