Charles MCP Server

MCP-сервер для Charles Proxy: агент читает трафик во время записи и сохраненные сессии, а детали открывает по одному запросу

331 ★ репозитория
Последний коммит 23 июн. 2026
MIT

MCP-сервер

heizaheiza/charles-mcpАвтор:heizaheiza

Установка

Работает в: Claude Code
Claude Desktop
Cursor
Codex
Windsurf
SourceCraft
Koda
Coddy

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/charles-mcp-server

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

Все ответы приходят без маскирования, поэтому токены, куки и пароли из трафика попадают в контекст агента
Инструменты reverse_* повторяют запросы с измененными параметрами и ищут поля подписи, это может затронуть боевые сервисы

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер подключает Charles Proxy к MCP-клиенту, чтобы агент разбирал сетевой трафик приложения. Пока идет запись, агент получает новые запросы порциями. Сохраненные сессии в файлах .chlsj он анализирует так же. Вывод построен от общего к частному. Сначала агент получает сводку и группировку по хостам, путям и статусам, затем выбирает нужную запись и просит детали. По умолчанию тело запроса обрезается до 2048 символов. При слишком большом ответе сервер предупреждает и предлагает сузить выборку, так что сырые дампы не забивают контекст. В публичном наборе 31 инструмент в четырех группах: запись, анализ и история, управление и ветка reverse_*. Управление проверяет статус Charles, сбрасывает окружение и имитирует сеть 3G, 4G и 5G. Ветка reverse_* появилась в версии 3.0 для разбора протоколов собственных приложений.

Для кого. Для мобильных и веб-разработчиков, тестировщиков и исследователей протоколов, которые уже работают с Charles Proxy.

Подходит, если

Нужно найти среди сотен запросов приложения те, что вернули ошибку, и показать агенту только их
Хочется, чтобы агент сам нашел горячие хосты и пути в только что записанной сессии
Проверяете, как приложение ведет себя на медленной сети: сервер включает пресеты 3G, 4G и 5G
Разбираете собственный API: нужно понять, какие поля запроса меняются от вызова к вызову
Готовите воспроизведение запроса со своего приложения для проверки его устойчивости к изменению параметров

Не подходит, если

Charles Proxy не установлен или его веб-интерфейс выключен: сервер без него ничего не увидит
Анализировать надо чужой трафик без разрешения владельца: инструмент для авторизованной отладки и тестирования
Нужна только фильтрация логов уже сохраненных файлов HAR: проще открыть их в браузерных инструментах
Агент подключен к общему окружению, где в трафике лежат чужие токены: ответы не маскируются

Пример запроса к агенту

Начни живую запись в Charles, потом покажи хосты с самым большим числом ошибок и открой подробности первого запроса со статусом 500.

MCP

Транспорт: stdio
Авторизация: API-ключ

Переменные окружения

CHARLES_USER обязательная: Логин веб-интерфейса Charles.
CHARLES_PASS обязательная, секрет: Пароль веб-интерфейса Charles.
CHARLES_MANAGE_LIFECYCLE: true передает серверу запуск и остановку Charles; по умолчанию false.
CHARLES_PROXY_PORT: Порт прокси Charles, по умолчанию 8888.

Ограничения

Нужны Python 3.10 или новее, пакетный менеджер uv и запущенный Charles Proxy с включенным веб-интерфейсом. Логин и пароль этого интерфейса должны совпадать с переменными CHARLES_USER и CHARLES_PASS. Прокси по умолчанию слушает 127.0.0.1:8888. Старые инструменты filter_func, proxy_by_time и list_sessions по умолчанию отключены. После обновления с версий до 3.0 переменная CHARLES_VNEXT_STATE_DIR устарела, и при первом запуске состояние переезжает в CHARLES_REVERSE_STATE_DIR.

Как отключить. Удалите сервер из настроек клиента, в Claude Code командой claude mcp remove charles. Веб-интерфейс Charles после этого можно выключить в меню Proxy, Web Interface Settings.

Частые вопросы

Как подключить Charles MCP к Claude Code?

Через claude mcp add-json charles с конфигурацией типа stdio: command uvx, args charles-mcp, в env логин и пароль веб-интерфейса Charles и CHARLES_MANAGE_LIFECYCLE со значением false. Для Claude Desktop, Cursor и Codex CLI автор дает отдельные фрагменты конфигурации.

Зачем нужен параметр CHARLES_MANAGE_LIFECYCLE?

Если поставить true, сервер сам управляет запуском и остановкой Charles и закроет процесс при выходе. По умолчанию стоит false, чтобы сервер не завершал ваш Charles.

Чем start_live_capture отличается от read_live_capture и peek_live_capture?

start_live_capture начинает или подхватывает запись и не очищает уже пойманный трафик. read_live_capture читает новые записи и сдвигает курсор, peek_live_capture показывает их без сдвига. query_live_capture_entries только фильтрует и курсор не трогает.

Что такое reverse-инструменты в версии 3.0?

Это 16 инструментов с префиксом reverse_: импорт сессий Charles, запросы по импортированным записям, декодирование тел, повтор запроса с изменением параметров, поиск полей-кандидатов в подписи и три сценария анализа трафика во время записи (вход, API, подпись). Используйте их только на своих приложениях или с разрешения владельца.

Какие значения по умолчанию для размера ответа?

Сервер сокращает вывод, чтобы беречь контекст: max_items равен 10, max_preview_chars 128, max_headers_per_side 6, max_body_chars 2048. Нужен больший объем, передайте значения выше вручную.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

1C Debug MCP Server

Российский стек

MCP-сервер на Go для отладки 1С через HTTP Debug Protocol: точки останова, пошаговое выполнение и просмотр переменных

MCP-серверШирокий доступ19

MCP Inspector

Выбор редакции

Официальный отладчик MCP-серверов: веб-интерфейс, CLI для автоматизации и терминальный интерфейс в одном пакете

CLIРасширенный доступ11,2 тыс.

Vibetest Use

Нужен VPN

MCP-сервер, который запускает несколько браузерных агентов и проверяет сайт на битые ссылки, ошибки интерфейса и доступность

MCP-серверРасширенный доступ832

claude-tap

Локальный прокси и просмотрщик трафика для кодинг-агентов: показывает системные промпты, вызовы инструментов и расход токенов Claude Code, Codex и других CLI

CLIРасширенный доступ3,3 тыс.

Firefox DevTools MCP

Официальный

MCP-сервер от Mozilla: агент управляет Firefox через WebDriver BiDi, читает консоль и сеть, делает снимки страниц и профилирует загрузку

MCP-серверШирокий доступ529

Сравнение RAG и RLM MCP-серверов для 1С

perform_comparison_1c_rag_mcp