Proxy Doctor
Find and fix corporate or system proxy settings that block Cursor, VS Code, or Windsurf from reaching model APIs.
Overview
Proxy Doctor is an Operate-phase MCP server that diagnoses proxy misconfigurations breaking Cursor, VS Code, Windsurf, and similar AI coding tools.
What is this MCP server?
- Diagnoses proxy misconfigurations affecting AI coding tools
- Explicitly targets Cursor, VS Code, and Windsurf environments
- Stdio PyPI package proxy-doctor (v0.2.1)
- Focused on connectivity breaks, not general MCP contract lint
- Pairs with the same author's MCP Doctor for complementary checks
- PyPI package proxy-doctor version 0.2.1
- Documented focus on Cursor, VS Code, and Windsurf
- Stdio transport; repository github.com/Jiansen/proxy-doctor
What problem does it solve?
AI IDEs often fail to reach APIs behind corporate proxies, leaving you guessing whether the bug is credentials, extension config, or network policy.
Who is it for?
Indie devs coding on corporate laptops, VPNs, or mandated HTTP proxies where Cursor or Windsurf suddenly stop streaming completions.
Skip if: Home networks with direct internet access and no proxy, where failures are clearly API keys or billing—not connectivity.
What do I get? / Deliverables
After diagnosis, you can align proxy env vars and client settings so model calls work reliably on restricted networks.
- Report of likely proxy-related misconfigurations
- Guidance aligned to Cursor, VS Code, and Windsurf setups
- Clearer separation of network vs API-key failure modes
Recommended MCP Servers
Journey fit
Proxy and network path failures surface when you are trying to work in production-like environments—Operate infra—not when you are sketching product ideas. Infra is the shelf for environment misconfiguration tooling that keeps AI coding clients online behind VPNs and HTTP proxies.
How it compares
Network/proxy diagnostic MCP, not MCP Doctor’s contract-quality reviewer for server manifests.
Common Questions / FAQ
Who is Proxy Doctor for?
Developers using Cursor, VS Code, or Windsurf on networks that require HTTP proxies or TLS inspection.
When should I use Proxy Doctor?
Use it in Operate when AI coding tools work off-network but fail on VPN or office Wi-Fi with proxy-related errors.
How do I add Proxy Doctor to my agent?
Install proxy-doctor from PyPI, add it as a stdio MCP server in your client, and run its diagnostics while reproducing the blocked IDE session.