HProxy MCP server
2026년 11월 8일 커밋AI 어시스턴트를 위한 무료 프록시 리스트, 실시간 프록시 점검 및 IP 조회 기능을 제공합니다.
다른 이름 hproxy-com/hproxy-mcp, hproxy-mcp
- 스타
- 0
- Tools
- 3
- 다운로드, 30일
- —
- 최신 버전
- 1.0.1
- 마지막 커밋
- 2026년 11월 8일
- 라이선스
- MIT
HProxy MCP란?
AI 어시스턴트를 위한 무료 프록시 리스트, 실시간 프록시 점검 및 IP 조회 기능을 제공합니다. 3개 도구를 제공합니다. 예: proxy_list, proxy_check, ip_lookup.
프로젝트 README에서 생성된 요약
HProxy MCP server 정보
HProxy는 AI 어시스턴트가 무료 프록시 리스트, 실시간 프록시 테스트 및 IP 조회 데이터에 접근할 수 있도록 하는 원격 MCP server를 제공합니다. Streamable HTTP를 통해 작동하며, 작동을 위해 API 키, 계정 또는 로컬 설치가 전혀 필요하지 않습니다. 개발자는 원격 URL을 제공하여 Claude Desktop, ChatGPT, Cursor, VS Code, Windsurf, Gemini CLI 등 다양한 클라이언트에 연결할 수 있습니다.
이 서버는 네트워크 데이터 관리를 위한 세 가지 특정 도구를 포함합니다. proxy_list 도구는 익명성 등급, 국가, 프로토콜 및 수량에 따라 필터링된 공개 프록시를 가져옵니다. proxy_check 도구는 최대 25개의 IP 주소에 대해 실시간 연결 테스트를 수행하여 지연 시간과 상태를 확인합니다. 마지막으로 ip_lookup 도구는 한 번에 최대 50개의 IP 주소에 대한 지리적 및 네트워크 세부 정보를 식별합니다. 이는 공개 프록시이므로, 이 서버는 민감한 개인 정보를 처리하기보다는 테스트 및 연구 목적으로 설계되었습니다.
활용 사례
- 1필터링된 프록시 리스트 가져오기특정 국가의 Elite SOCKS5 프록시를 원하는 수량만큼 요청합니다.
- 2프록시 연결성 확인IP 주소 리스트를 테스트하여 현재 활성화된 주소와 지연 시간을 확인합니다.
- 3IP 인텔리전스 조회 수행특정 IP 주소의 네트워크 제공업체와 지리적 위치를 식별합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
HProxy MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 HProxy MCP 설치
$ claude mcp add --transport http hproxy-mcp https://mcp.hproxy.com/mcpCursor에 HProxy MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"hproxy-mcp": {
"url": "https://mcp.hproxy.com/mcp"
}
}
}VS Code에 HProxy MCP 설치
.vscode/mcp.json
{
"servers": {
"hproxy-mcp": {
"type": "http",
"url": "https://mcp.hproxy.com/mcp"
}
}
}VS Code CLI에 HProxy MCP 설치
$ code --add-mcp '{"name":"hproxy-mcp","type":"http","url":"https://mcp.hproxy.com/mcp"}'Codex에 HProxy MCP 설치
$ codex mcp add hproxy-mcp --url https://mcp.hproxy.com/mcpCodex config.toml에 HProxy MCP 설치
~/.codex/config.toml
[mcp_servers.hproxy-mcp] url = "https://mcp.hproxy.com/mcp"
Gemini CLI에 HProxy MCP 설치
$ gemini mcp add -s user --transport http hproxy-mcp https://mcp.hproxy.com/mcpGemini settings.json에 HProxy MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"hproxy-mcp": {
"url": "https://mcp.hproxy.com/mcp",
"type": "http"
}
}
}HProxy MCP 도구 3
README에서 감지됨proxy_listproxy_checkip_lookup
| proxy_list | — | |
| proxy_check | — | |
| ip_lookup | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능hproxy-com/hproxy-mcp is public and reachablegithub.com/hproxy-com/hproxy-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-08github.com/hproxy-com/hproxy-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음3 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-06-18 in 97 ms통과
README
GitHub에서 보기HProxy MCP server
A free proxy list, a live proxy checker and an IP lookup for AI assistants, hosted by HProxy at one address. No key, no account, nothing to install.
https://mcp.hproxy.com/mcp
It speaks MCP over Streamable HTTP and is listed in the official MCP Registry as com.hproxy/mcp.
Add it to your assistant
Claude Code. In a terminal:
claude mcp add --transport http hproxy https://mcp.hproxy.com/mcp
Or as a plugin: the server plus a skill that tells Claude how to use it well. In a terminal:
claude plugin marketplace add hproxy-com/hproxy-mcp
claude plugin install hproxy@hproxy
Claude and Claude Desktop. Settings, Connectors, Add custom connector, then paste the address:
https://mcp.hproxy.com/mcp
ChatGPT. Settings, Security and login, turn on Developer mode, then create an app with this address and No authentication (Plus, Pro, Business, Enterprise and Education, on the web):
https://mcp.hproxy.com/mcp
Cursor. In ~/.cursor/mcp.json:
{ "mcpServers": { "hproxy": { "url": "https://mcp.hproxy.com/mcp" } } }
VS Code. In .vscode/mcp.json:
{ "servers": { "hproxy": { "type": "http", "url": "https://mcp.hproxy.com/mcp" } } }
Windsurf. In ~/.codeium/windsurf/mcp_config.json:
{ "mcpServers": { "hproxy": { "serverUrl": "https://mcp.hproxy.com/mcp" } } }
Gemini CLI. As an extension: the server plus a short guide for the model. In a terminal:
gemini extensions install https://github.com/hproxy-com/hproxy-mcp
Or by hand, in ~/.gemini/settings.json:
{ "mcpServers": { "hproxy": { "httpUrl": "https://mcp.hproxy.com/mcp" } } }
Any other MCP client. Add https://mcp.hproxy.com/mcp as a remote server (Streamable HTTP) with no authentication.
The tools
| Tool | What it does | Arguments |
|---|---|---|
proxy_list |
Fetch live free proxies from HProxy's public pool, re-checked around the clock. No key. Returns ip, port, protocols, anonymity, country, city, network, latency and 24h uptime per proxy. Use this when the user wants free proxies to test with. Free proxies are public and come and go, so check them before relying on one. | anonymity: one of elite, anonymous, transparent. Only proxies of exactly this anonymity grade: elite hides both your address and the fact that a proxy is used, anonymous hides your address, transparent passes it on.country: ISO 3166 alpha-2 country code, e.g. 'de'. Omit for every country.limit: 1 to 200, default 25. How many to return. The full list is thousands; ask for what you need.protocol: one of http, https, socks4, socks5. Only proxies speaking this protocol. |
proxy_check |
Run a real live test on one or more proxies: is it alive, which protocols it speaks, its anonymity grade, latency and location. No key. Each check opens a real connection, so a dead proxy can take a few seconds. Up to 25 per call. | proxies (required): Proxies as ip:port, e.g. ['203.0.113.7:1080']. Up to 25. |
ip_lookup |
Look up any public IP address: country, region, city, coordinates, timezone, ASN and the network that runs it. No key. Up to 50 per call. | ips (required): IPv4 or IPv6 addresses. One is the common case. |
All three only read. None of them needs a key.
Things to ask
- "Give me twenty elite German SOCKS5 proxies and check which are alive."
- "Find five fast US HTTP proxies, test them, and give me only the working ones."
- "Who runs the network behind 8.8.8.8, and where is it?"
Good to know
- These are public free proxies. Expect fewer than half to answer at any moment, set short timeouts, and never send passwords or personal data through one.
- Limits are per IP address. The checker takes 120 requests in a burst, then 5 a second, and 300,000 proxies a day, because every check opens a real connection. Past a limit, the tool says how many seconds to wait.
- For proxies that must hold up against real blocking, HProxy sells residential proxies.
The same tools without MCP
Plain HTTP, no key, CORS open:
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"
Documentation: free proxy list API, proxy checker API, IP lookup API. Written for language models: hproxy.com/llms.txt.
From a terminal: the hproxy command, one file for macOS, Linux and Windows, built in public from source (the release). Install it in one line on macOS and Linux:
curl -fsSL https://hproxy.com/install.sh | sh
On Windows, in PowerShell:
irm https://hproxy.com/install.ps1 | iex
Then:
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 serves the same three tools as a local MCP server, for an assistant that starts programs on your computer.
The whole list as plain files, updated around the clock: hproxy-com/free-proxy-list.
Support
Support is staffed around the clock at hproxy.com/contact. You may build these tools into your own software, free of charge and without asking.
License
MIT, for the files in this repository.
HProxy MCP 질문
HProxy MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http hproxy-mcp https://mcp.hproxy.com/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
HProxy MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
HProxy MCP는 어떤 도구를 제공하나요?
3개 도구를 제공합니다. 예: proxy_list, proxy_check, ip_lookup.
HProxy를 사용하려면 API 키가 필요한가요?
아니요, 이 서버는 키나 계정이 필요 없으며 별도로 설치할 것도 없습니다.
프록시 리스트에는 어떤 정보가 포함되어 있나요?
리스트에는 각 프록시별 IP, 포트, 프로토콜, 익명성, 국가, 도시, 네트워크, 지연 시간 및 24시간 가동 시간이 포함됩니다.
이 프록시들을 민감한 데이터 처리에 사용해도 되나요?
아니요, 이는 공개된 무료 프록시입니다. 타임아웃을 짧게 설정해야 하며, 비밀번호나 개인 정보를 절대 전송하지 마십시오.
한 번에 몇 개의 프록시를 점검할 수 있나요?
호출당 최대 25개의 프록시를 점검할 수 있습니다.