MiniApp CDP MCP
MiniApp CDP MCP
English | 中文
MCP-сервер для обратной разработки мини-программ WeChat, позволяющий вашим ИИ-ассистентам (таким как Claude, Cursor, Antigravity) напрямую отлаживать и анализировать JavaScript-код в мини-программах WeChat (включая WeChat DevTools или мини-программы WeChat для ПК) через протокол Chrome DevTools (CDP).
Функциональные особенности
Отладка нескольких целей: Поддержка бесшовного переключения между целями
AppService(логический слой) иWebView(слой рендеринга)Перехват сети: Перехват, мониторинг и фильтрация XHR/Fetch-запросов, инициированных мини-программой
Отладка с точками останова: Установка/удаление точек останова в коде и XHR-запросах, поддержка точного позиционирования в сжатом и обфусцированном коде
Управление выполнением: Приостановка/возобновление выполнения, пошаговая отладка (over/into/out) с возвратом контекста исходного кода
Анализ скриптов: Список всех загруженных JS-скриптов, поиск по коду, получение/сохранение исходного кода
Инспекция среды выполнения: Вычисление выражений в точках останова, проверка стека вызовов и переменных области видимости
Анализ WebSocket: Мониторинг WebSocket-соединений и шаблонов сообщений
Related MCP server: wmpf-mcp
Системные требования
Python 3.11 или новее
uv (обязательно, сверхбыстрый менеджер пакетов и окружений Python)
Запущенные WeChat DevTools (с включенным портом отладки) или мини-программа WeChat для ПК (с включенным механизмом удаленной отладки)
Подготовка 1: Включение порта отладки мини-программы
Перед использованием этого MCP вам необходимо сначала открыть порт отладки CDP мини-программы WeChat с помощью инструментов внедрения. Вы можете выбрать один из следующих инструментов с открытым исходным кодом в зависимости от вашей операционной системы и версии WeChat для выполнения Hook и открытия порта (обычно порт 62000):
WMPFDebugger-arm (для архитектуры macOS ARM)
Подготовка 2: Установка uv
Данный проект реализует принцип «из коробки» без настройки через uvx. Если вы еще не установили uv, выполните следующую команду в зависимости от вашей системы:
macOS / Linux:
curl -LsSf https://astral.sh/uv/install.sh | shWindows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Быстрый старт (uvx без установки)
Вам не нужно клонировать код локально, вы можете напрямую использовать возможности uv, добавив следующее в конфигурационный файл MCP вашего ИИ-ассистента:
{
"mcpServers": {
"miniapp-cdp": {
"command": "uvx",
"args": ["--from", "miniapp-cdp", "miniapp-cdp-mcp"]
}
}
}Claude Desktop
Отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json, добавив указанную выше конфигурацию.
Cursor
Перейдите в Cursor Settings -> Features -> MCP -> Add new MCP server:
Type:
commandName:
miniapp-cdpCommand:
uvx --from miniapp-cdp miniapp-cdp-mcp
Локальная установка (опционально)
Если вы хотите вносить изменения или разрабатывать локально:
git clone https://github.com/yourusername/miniapp-cdp-py.git
cd miniapp-cdp-py
uv syncЗатем используйте локальный запуск в конфигурации MCP:
{
"mcpServers": {
"miniapp-cdp": {
"command": "uv",
"args": ["run", "run_mcp_server.py"],
"cwd": "/你的路径/miniapp-cdp-py"
}
}
}Список инструментов
Управление целями и контекстом
Инструмент | Описание |
| Список всех доступных целей в отладчике (поток AppService, поток WebView и т.д.) |
| Переключение CDP-соединения на другой целевой поток для смены контекста отладки |
Сеть и WebSocket
Инструмент | Описание |
| Список сетевых запросов мини-программы (с поддержкой пагинации) или получение деталей одного запроса |
| Получение стека вызовов JavaScript, инициировавшего сетевой запрос |
| Получение полного тела ответа сетевого запроса |
| Список WebSocket-соединений или получение деталей сообщений конкретного соединения |
Анализ скриптов
Инструмент | Описание |
| Список всех JavaScript-скриптов, загруженных на текущей странице |
| Получение фрагмента исходного кода скрипта, поддержка диапазонов строк или смещений символов |
| Сохранение полного исходного кода скрипта в локальный файл (подходит для извлечения всего пакета или кода защиты) |
| Поиск строки или регулярного выражения во всех скриптах |
Точки останова и управление выполнением
Инструмент | Описание |
| Автоматическая установка точки останова через поиск текста кода (не ставьте точки останова непосредственно на анонимные объявления функций) |
| Установка точки останова XHR/Fetch по шаблону URL |
| Удаление указанных точек останова или мгновенная очистка всех точек через |
| Список всех активных точек останова |
| Получение информации о состоянии паузы, стеке вызовов и переменных области видимости |
| Снятие точки останова, возобновление выполнения кода |
| Пошаговая отладка (over/into/out), возврат позиции и контекста исходного кода |
Инструменты инспекции
Инструмент | Описание |
| Выполнение JavaScript-выражения в текущем контексте (поддерживается при паузе на точке останова) |
Примеры использования
Базовый процесс обратной разработки мини-программы
Подключение и переключение целей
列出所有小程序目标,并切换到 AppService (逻辑层) 线程Поиск целевых функций и кода
在所有脚本中搜索包含 "encrypt" 的代码,并获取相关脚本的上下文源码Установка точек останова
在加密函数的具体执行语句(如 return 处)设置断点Триггер и анализ
在小程序上点击触发网络请求,断点命中后,检查参数、调用栈以及密钥的生成逻辑Перехват и анализ сетевых запросов
抓取最新发出的网络请求列表,并找出特定的加密请求(如带有 mina_edata 参数的请求),
随后获取该请求的发起者调用栈 (Initiator) 定位加密入口。Практические примеры
В директории examples/ проекта содержатся практические скрипты, полученные путем обратной разработки с помощью этого инструмента (например, vipshop_decrypt_demo.py), которые демонстрируют, как анализировать сложные многоуровневые алгоритмы шифрования мини-программ через MCP и идеально восстанавливать их на Python.
Уведомление о безопасности
Этот инструмент открывает низкоуровневый контекст выполнения мини-программы для MCP-клиента, позволяя проверять, отлаживать и изменять любые данные в памяти приложения. Пожалуйста, не используйте этот инструмент в незаконных целях; он предназначен только для личного обучения, исследований в области безопасности и законного обратного анализа.
Благодарности
Этот проект построен на базе cdp-use. cdp-use предоставляет низкоуровневый слой взаимодействия WebSocket, оптимизированный и абстрагированный для сценариев агентов, что значительно упрощает сложность связи по протоколу CDP.
Лицензия
MIT License
Available Tools
19 toolsbreak_on_xhrA
Sets a breakpoint that triggers when an XHR/Fetch request URL contains the specified string.
Inputs: url (required). Returns: result
evaluate_scriptC
Evaluates a JavaScript expression in the current context. If execution is paused, it automatically evaluates in the paused call frame context.
Inputs: expression (required), return_by_value, await_promise, context_id, +1 more. Returns: result
get_paused_infoA
Gets information about the current paused state including call stack, current location, and scope variables. Use this after a breakpoint is hit to understand the execution context.
Inputs: include_scopes, max_scope_depth, frame_index. Returns: result
get_request_initiatorB
Gets the JavaScript call stack that initiated a network request. This helps trace which code triggered an API call.
Inputs: request_id (required). Returns: result
get_response_bodyA
Get the response body for a request returned by list_network_requests. If session_id is omitted, it is inferred from the monitored request cache.
Inputs: request_id (required), session_id. Returns: result
get_script_sourceB
Gets a snippet of a JavaScript script source by URL (recommended) or script ID. Supports line range (for normal files) or character offset (for minified single-line files).
Inputs: script_id, url, start_line, end_line, +2 more. Returns: result
get_websocket_messagesB
Lists WebSocket connections or gets messages for a specific connection. Without wsid, lists all connections. With wsid, gets messages.
Inputs: wsid, direction, show_content, page_size, +1 more. Returns: result
list_breakpointsB
Lists all active XHR and code breakpoints.
Inputs: no named parameters. Returns: result
list_network_requestsA
List network requests for the currently selected miniapp target/session since MCP started monitoring it. Results are sorted newest-first. By default returns the 20 most recent requests; use page_size/page_idx to paginate. Pass reqid to get a single request's full details. On first call it automatically connects to the endpoint, infers the target, attaches only that target, enables Network on that target session, and starts collecting XHR/Fetch requests.
Inputs: endpoint, reqid, page_size, page_idx, +5 more. Returns: result
list_scriptsA
Lists all JavaScript scripts loaded in the current page. Returns script ID, URL, and source map information. Use this to find scripts before setting breakpoints or searching.
Inputs: url_filter. Returns: result
list_targetsB
Lists all available targets (WebView threads, AppService threads, etc.) in the connected debugger.
Inputs: no named parameters. Returns: result
pause_or_resumeB
Toggles JavaScript execution. If paused, resumes execution. If running, pauses execution.
Inputs: no named parameters. Returns: result
remove_breakpointB
Removes a breakpoint by its ID.
Inputs: breakpoint_id (required). Returns: result
remove_xhr_breakpointC
Removes an XHR/Fetch breakpoint.
Inputs: url (required). Returns: result
save_script_sourceC
Saves the full source code of a JavaScript script to a local file.
Inputs: file_path (required), script_id, url. Returns: result
search_in_sourcesB
Searches for a string or regex pattern in all loaded JavaScript sources. Returns matching lines with script ID, URL, and line number.
Inputs: query (required), case_sensitive, is_regex, max_results, +3 more. Returns: result
set_breakpoint_on_textA
Finds a text string in all loaded scripts and sets a breakpoint at that location. CRITICAL AI WORKFLOW WARNING: Do NOT set breakpoints on function names or assignment statements (e.g., 'funcName = function'). In minified code, this will break on the one-time assignment rather than the execution. Instead, ALWAYS use get_script_source to read the function body first, then set the breakpoint on a specific statement INSIDE the function body (e.g., 'var x=', 'return').
Inputs: text (required), case_sensitive, condition. Returns: result
stepB
Controls execution when paused. action must be one of: 'over', 'into', 'out'.
Inputs: action (required). Returns: result
switch_targetB
Switches the CDP connection to a different target thread (e.g. from WebView to AppService) to debug different parts of the miniapp.
Inputs: target_id (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Most tools have distinct purposes with clear boundaries, such as break_on_xhr for XHR breakpoints versus set_breakpoint_on_text for code breakpoints. However, some overlap exists between list_breakpoints and remove_breakpoint/remove_xhr_breakpoint, as they all manage breakpoints but with different granularities, which could cause minor confusion in selection.
Tool names follow a highly consistent verb_noun or verb_noun_noun pattern throughout, such as list_network_requests, get_paused_info, and remove_xhr_breakpoint. There are no deviations in style or convention, making the set predictable and easy to navigate.
With 19 tools, the count is slightly high but reasonable for a comprehensive debugging and monitoring server for miniapps. It covers various aspects like breakpoints, network requests, and script analysis without feeling excessively bloated, though it might be borderline for some use cases.
The toolset provides complete coverage for debugging miniapps, including breakpoint management, network monitoring, script inspection, and execution control. There are no obvious gaps; tools like step, pause_or_resume, and switch_target ensure full lifecycle support for debugging workflows.
Maintenance
Related MCP Connectors
Live browser debugging for AI assistants — DOM, console, network via MCP.
A paid remote MCP for AI agent browser DevTools MCP, built to return verdicts, receipts, usage logs,
Official Browserless MCP server: browser automation, scraping, screenshots and PDFs for AI agents.
Cloud browser, web extraction, screenshots, and remote CDP tools for AI agents.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI coding assistants to debug and analyze JavaScript code in web pages through breakpoint debugging, function hooking, network analysis, and runtime inspection of scripts including minified code.241,064 npm3,072Apache 2.0
- AlicenseBqualityDmaintenanceConnects to WMPFDebugger's CDP WebSocket to enable AI-assisted debugging of Windows WeChat Mini Programs, providing tools for JavaScript evaluation, script inspection, breakpoints, debugger control, and network inspection.211MIT
- AlicenseNot gradedqualityCmaintenanceEnables dynamic reverse engineering and debugging of WeChat MiniProgram JavaScript through the Chrome DevTools Protocol, letting AI agents enumerate and search scripts, set breakpoints, step through paused frames, trace function calls, hook miniprogram APIs such as wx.request, and capture network requests to analyze encryption, signing, and anti-scraping logic. It also works against Chrome, Node.js, and Electron runtimes, with tools for extracting code bundles and page business logic.31 npm1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI clients to inspect and control a running mini-program debugging host, including page actions, DOM/WeChat state, storage, logs, network bodies, source, breakpoints, and analysis tools.1Apache 2.0