Proxy Doctor

Proxy Doctor

JiansenMIT
1 звёзд
Когда браузер загружает сайты, а Cursor, VS Code или Windsurf не отвечают на запросы ИИ-помощника — причина почти всегда в прокси. Proxy Doctor проверяет настройки на пяти уровнях и указывает, что именно сломано. Утилита работает только на macOS и выдает готовые команды для исправления. Сервер предназначен для разработчиков и DevOps, которые настраивают окружение с AI-инструментами. Он автоматизирует диагностику и экономит часы на поиск проблемы.
Ai-mlDevelopmentVscode
Открыть на GitHub

Установка

uvx proxy-doctor

Характеристики

Общее

  • СтатусСообщество
  • РазработчикJiansen
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Проверяет системный прокси (HTTP/HTTPS/SOCKS) на всех сетевых интерфейсах macOS
  • Находит остаточные настройки от закрытых VPN-клиентов — записи с локальными адресами, которые висят в системе
  • Тестирует, отвечает ли порт, на который указывает прокси (через socket.connect)
  • Анализирует файлы конфигурации редактора: settings.json, argv.json, последние логи ошибок
  • Сканирует переменные окружения http_proxy и https_proxy в контексте GUI-приложений через launchctl
  • Генерирует список команд для каждого найденного дефекта — команда proxy-doctor fix
  • Выводит результат в JSON (для AI-агентов) или в читаемом виде для человека
  • Работает как MCP-сервер: AI-ассистент может вызывать диагностику через вызов инструмента
  • Поддерживает выбор редактора: cursor, vscode, windsurf

Как подключить

  1. Установите пакет с поддержкой MCP:
    2. pip install proxy-doctor[mcp]

    Или через uvx: uvx proxy-doctor (установка не требуется).

  2. Добавьте настройки в конфигурационный файл вашего MCP-хоста. Например, для Cursor откройте ~/.cursor/mcp.json и добавьте:
    3. { "mcpServers": { "proxy-doctor": { "command": "python3", "args": ["-m", "proxy_doctor.mcp_server"] } } }

    Если используете uvx, укажите "command": "uvx", "args": ["proxy-doctor"].

  3. Перезапустите клиент (Cursor, VS Code или другой хост).

Примеры запросов

  • «Проверь настройки прокси на моём Mac и покажи все проблемы.»
  • «Что сейчас настроено в системных прокси? Есть ли конфликты?»
  • «Найди остаточные записи от VPN и предложи команды для очистки.»
  • «Почему в Cursor не работают ИИ-функции? Проверь конфигурацию редактора.»

Технические детали

Язык: Python 3.9+

Транспорт: stdio (клиент запускает процесс)

Лицензия: MIT

Поддерживаемые клиенты: Cursor, VS Code, Windsurf; любые хосты, совместимые с MCP

Платформа: macOS (зависит от networksetup и launchctl)

Поделиться