Skip to main content
Glama

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):

Подготовка 2: Установка uv

Данный проект реализует принцип «из коробки» без настройки через uvx. Если вы еще не установили uv, выполните следующую команду в зависимости от вашей системы:

macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

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: command

  • Name: miniapp-cdp

  • Command: 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"
    }
  }
}

Список инструментов

Управление целями и контекстом

Инструмент

Описание

list_targets

Список всех доступных целей в отладчике (поток AppService, поток WebView и т.д.)

switch_target

Переключение CDP-соединения на другой целевой поток для смены контекста отладки

Сеть и WebSocket

Инструмент

Описание

list_network_requests

Список сетевых запросов мини-программы (с поддержкой пагинации) или получение деталей одного запроса

get_request_initiator

Получение стека вызовов JavaScript, инициировавшего сетевой запрос

get_response_body

Получение полного тела ответа сетевого запроса

get_websocket_messages

Список WebSocket-соединений или получение деталей сообщений конкретного соединения

Анализ скриптов

Инструмент

Описание

list_scripts

Список всех JavaScript-скриптов, загруженных на текущей странице

get_script_source

Получение фрагмента исходного кода скрипта, поддержка диапазонов строк или смещений символов

save_script_source

Сохранение полного исходного кода скрипта в локальный файл (подходит для извлечения всего пакета или кода защиты)

search_in_sources

Поиск строки или регулярного выражения во всех скриптах

Точки останова и управление выполнением

Инструмент

Описание

set_breakpoint_on_text

Автоматическая установка точки останова через поиск текста кода (не ставьте точки останова непосредственно на анонимные объявления функций)

break_on_xhr

Установка точки останова XHR/Fetch по шаблону URL

remove_breakpoints

Удаление указанных точек останова или мгновенная очистка всех точек через clear_all=True

list_breakpoints

Список всех активных точек останова

get_paused_info

Получение информации о состоянии паузы, стеке вызовов и переменных области видимости

resume_execution

Снятие точки останова, возобновление выполнения кода

step

Пошаговая отладка (over/into/out), возврат позиции и контекста исходного кода

Инструменты инспекции

Инструмент

Описание

evaluate_script

Выполнение JavaScript-выражения в текущем контексте (поддерживается при паузе на точке останова)

Примеры использования

Базовый процесс обратной разработки мини-программы

  1. Подключение и переключение целей

列出所有小程序目标,并切换到 AppService (逻辑层) 线程
  1. Поиск целевых функций и кода

在所有脚本中搜索包含 "encrypt" 的代码,并获取相关脚本的上下文源码
  1. Установка точек останова

在加密函数的具体执行语句(如 return 处)设置断点
  1. Триггер и анализ

在小程序上点击触发网络请求,断点命中后,检查参数、调用栈以及密钥的生成逻辑

Перехват и анализ сетевых запросов

抓取最新发出的网络请求列表,并找出特定的加密请求(如带有 mina_edata 参数的请求),
随后获取该请求的发起者调用栈 (Initiator) 定位加密入口。

Практические примеры

В директории examples/ проекта содержатся практические скрипты, полученные путем обратной разработки с помощью этого инструмента (например, vipshop_decrypt_demo.py), которые демонстрируют, как анализировать сложные многоуровневые алгоритмы шифрования мини-программ через MCP и идеально восстанавливать их на Python.

Уведомление о безопасности

Этот инструмент открывает низкоуровневый контекст выполнения мини-программы для MCP-клиента, позволяя проверять, отлаживать и изменять любые данные в памяти приложения. Пожалуйста, не используйте этот инструмент в незаконных целях; он предназначен только для личного обучения, исследований в области безопасности и законного обратного анализа.

Благодарности

Этот проект построен на базе cdp-use. cdp-use предоставляет низкоуровневый слой взаимодействия WebSocket, оптимизированный и абстрагированный для сценариев агентов, что значительно упрощает сложность связи по протоколу CDP.

Лицензия

MIT License

Available Tools

19 tools
break_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

    A3.5/5.0

    Scored across 19 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      24
      1,064 npm
      3,072
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      Connects 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.
      21
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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.
      1
      Apache 2.0