关于 HProxy
HProxy 为 AI 助手和 Agent 提供免费的代理列表、实时代理检测和 IP 查询,无需密钥、账户或安装。服务以只读工具呈现,也提供本地 MCP 服务和命令行入口。
主要功能
- 01按协议、国家和匿名等级筛选代理
- 02实时检测代理可用性与属性
- 03查询 IP 的位置和网络信息
- 04每次最多检测 25 个代理
- 05提供对应的命令行工具
适用场景
- 01筛选并验证测试用免费代理
- 02查看某个公共 IP 的网络归属
- 03通过命令行执行代理和 IP 查询
MCP 相关
提供采用 Streamable HTTP 的远程 MCP 服务,包含代理列表、检测和 IP 查询工具;也可运行本地 MCP 服务。无需认证。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.hproxy.com/mcpclaude mcp add --transport http com-hproxy https://mcp.hproxy.com/mcp{"mcpServers":{"com-hproxy":{"type":"http","url":"https://mcp.hproxy.com/mcp"}}}在 Cursor 中打开{"servers":{"com-hproxy":{"type":"http","url":"https://mcp.hproxy.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-hproxy":{"type":"http","url":"https://mcp.hproxy.com/mcp"}}}{"mcpServers":{"com-hproxy":{"serverUrl":"https://mcp.hproxy.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
3| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 返回数量。完整列表有数千条,请按需指定。 |
| country | string | 否 | ISO 3166 alpha-2 国家/地区代码,例如 'de'。省略则包含所有国家/地区。 |
| protocol | enum | 否 | 仅返回使用此协议的代理。http | https | socks4 | socks5 |
| anonymity | enum | 否 | 仅使用此匿名等级的代理:elite 会隐藏你的地址和使用代理这一事实,anonymous 会隐藏你的地址,transparent 会转发你的地址。elite | anonymous | transparent |
详细介绍
HProxy MCP 服务
由 HProxy 托管的一站式服务,为 AI 助手提供免费代理列表、实时代理检查器和 IP 查询。无需密钥、无需账户,也无需安装任何东西。
https://mcp.hproxy.com/mcp
它通过 Streamable HTTP 提供 MCP 服务,并已列入 官方 MCP Registry,名称为 com.hproxy/mcp。
将其添加到你的助手
Claude Code。 在终端中:
claude mcp add --transport http hproxy https://mcp.hproxy.com/mcp
也可以将其作为插件添加:包含服务,以及一项指导 Claude 如何更好地使用它的技能。在终端中:
claude plugin marketplace add hproxy-com/hproxy-mcp
claude plugin install hproxy@hproxy
Claude 和 Claude Desktop。 依次选择 Settings、Connectors、Add custom connector,然后粘贴地址:
https://mcp.hproxy.com/mcp
ChatGPT。 依次选择 Settings、Security and login,开启 Developer mode,然后使用此地址创建应用并选择 No authentication(适用于网页版的 Plus、Pro、Business、Enterprise 和 Education):
https://mcp.hproxy.com/mcp
Cursor。 在 ~/.cursor/mcp.json 中:
{ "mcpServers": { "hproxy": { "url": "https://mcp.hproxy.com/mcp" } } }
VS Code。 在 .vscode/mcp.json 中:
{ "servers": { "hproxy": { "type": "http", "url": "https://mcp.hproxy.com/mcp" } } }
Windsurf。 在 ~/.codeium/windsurf/mcp_config.json 中:
{ "mcpServers": { "hproxy": { "serverUrl": "https://mcp.hproxy.com/mcp" } } }
Gemini CLI。 将其作为扩展添加:包含服务,以及一份供模型使用的简短指南。在终端中:
gemini extensions install https://github.com/hproxy-com/hproxy-mcp
或者手动添加到 ~/.gemini/settings.json 中:
{ "mcpServers": { "hproxy": { "httpUrl": "https://mcp.hproxy.com/mcp" } } }
任何其他 MCP 客户端。 将 https://mcp.hproxy.com/mcp 添加为远程服务(Streamable HTTP),无需身份验证。
工具
| 工具 | 功能 | 参数 |
|---|---|---|
proxy_list | 从 HProxy 的公共代理池中获取实时免费代理,该代理池全天候重新检查。无需密钥。每个代理会返回 IP、端口、协议、匿名级别、国家/地区、城市、网络、延迟和过去 24 小时的正常运行时间。用户需要免费代理进行测试时使用此工具;若需要能够经受实际封锁的代理,请访问 https://hproxy.com/pricing 购买 HProxy 付费代理池。 | anonymity:elite、anonymous、transparent 之一。仅返回匿名级别完全匹配的代理:elite 会隐藏你的地址以及正在使用代理这一事实,anonymous 会隐藏你的地址,transparent 则会传递你的地址。country:ISO 3166 两位字母国家/地区代码,例如 'de'。省略则返回所有国家/地区的代理。limit:1 到 200,默认值为 25。返回数量。完整列表有数千条;请按需指定数量。protocol:http、https、socks4、socks5 之一。仅返回支持此协议的代理。 |
proxy_check | 对一个或多个代理进行实时测试:检查代理是否可用、支持哪些协议、匿名级别、延迟和位置。无需密钥。每次检查都会建立真实连接,因此检查失效代理可能需要几秒钟。每次调用最多检查 25 个。 | proxies(必填):格式为 ip:port 的代理,例如 ['203.0.113.7:1080']。最多 25 个。 |
ip_lookup | 查询任何公共 IP 地址:国家/地区、区域、城市、坐标、时区、ASN 和所属网络。无需密钥。每次调用最多查询 50 个。 | ips(必填):IPv4 或 IPv6 地址。通常只需查询一个。 |
这三个工具都只读取数据,且都无需密钥。
可以这样提问
- “给我 20 个德国的 elite SOCKS5 代理,并检查哪些可用。”
- “找出 5 个速度快的美国 HTTP 代理,测试它们,并只返回可用的。”
- “8.8.8.8 背后的网络由谁运营?它位于哪里?”
需要了解的信息
- 这些都是公共免费代理。任何时候预计能响应的代理都不到一半,请设置较短的超时时间,且绝不要通过代理发送密码或个人数据。
- 限制按 IP 地址计算。检查器可以突发发送 120 个请求,之后速率为每秒 5 个,每天最多检查 300,000 个代理,因为每次检查都会建立真实连接。超过限制后,工具会告知需要等待多少秒。
- 对于需要经受实际封锁的代理,请访问 hproxy.com/pricing 购买 HProxy 付费代理。
不使用 MCP 的相同工具
纯 HTTP,无需密钥,开放 CORS:
curl "https://hproxy.com/api/proxy-list?format=json&protocol=socks5&country=us"
curl "https://hproxy.com/api/proxy-check?proxy=IP:PORT"
curl "https://hproxy.com/api/ip/8.8.8.8"
文档:免费代理列表 API、代理检测 API、IP 查询 API。专为大模型编写:hproxy.com/llms.txt。
在终端中使用:hproxy 命令,macOS、Linux 和 Windows 均可使用的单文件程序,以开放方式从源代码构建(发布版本)。在 macOS 和 Linux 上用一行命令安装:
curl -fsSL https://hproxy.com/install.sh | sh
在 Windows 上,使用 PowerShell:
irm https://hproxy.com/install.ps1 | iex
然后:
hproxy list --country DE --protocol socks5 --limit 20
hproxy check 203.0.113.7:1080 198.51.100.3:8080
hproxy ip 8.8.8.8
hproxy mcp 会将相同的三个工具作为本地 MCP 服务提供,供可在你的计算机上启动程序的助手使用。
完整列表以纯文件形式提供,并全天候更新:hproxy-com/free-proxy-list。
支持
支持团队全天候提供服务,请访问 hproxy.com/contact。你可以免费将这些工具集成到自己的软件中,无需征求许可。
许可证
本仓库中的文件采用 MIT 许可证。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。