wechat-devtools-mcp — MCP для WeChat DevTools
wechat-devtools-mcp
MCP-сервер и навык для WeChat DevTools: агент компилирует, запускает в превью, отлаживает и автотестирует мини-программы WeChat
- 166 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент управляет настольной IDE: компилирует, загружает проект, нажимает элементы и вызывает методы страниц
- Через сервер можно читать файлы проекта и выполнять код в среде мини-программы
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/wechat-devtools-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент управляет настольной IDE: компилирует, загружает проект, нажимает элементы и вызывает методы страниц
- Через сервер можно читать файлы проекта и выполнять код в среде мини-программы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер превращает WeChat DevTools, среду разработки мини-программ WeChat, в набор инструментов для агента. Автор называет схему «тонкий MCP и толстый навык»: у сервера семь сводных инструментов, а процедуры и приемы отладки лежат в парном навыке wechat-devtools (девять сценариев, справочник действий, поэтапная диагностика через CDP, разбор типовых сбоев). Инструменты разбиты по задачам. wechat_ide отвечает за запуск и вход, wechat_build за компиляцию, превью, загрузку и сборку npm. wechat_automator нажимает, вводит текст и читает данные страницы и состояние. wechat_inspector собирает журналы консоли и CDP, wechat_screenshot склеивает длинные скриншоты страниц, wechat_navigate переходит на страницу и собирает журналы, wechat_file читает файлы проекта. Сервер работает на Windows и macOS, ему нужны Python 3.10 или новее, Node.js 18 или новее и WeChat DevTools 2.x либо 1.06.x. Версия на момент проверки 0.9.21, сервер значится в официальном реестре MCP.
Для кого. Разработчикам мини-программ WeChat, которые хотят, чтобы агент в редакторе сам собирал проект, смотрел страницы и находил ошибки.
Подходит, если
- Мини-программа не собирается или падает в превью, и нужно собрать журналы консоли и CDP
- Требуется длинный скриншот страницы целиком, например для сверки с макетом
- Перед загрузкой нужно прогнать типовую проверку: переходы между страницами, данные страниц, состояние
- Агент должен нажимать элементы и подставлять данные, чтобы воспроизвести ошибку
Не подходит, если
- Вам нужны только открытие проекта, компиляция и загрузка в WeChat DevTools 2.x: для этого лучше подходит встроенный MCP среды
- Проект не относится к мини-программам WeChat: сервер работает только с ними
- Среда запускается без графической сессии: сервер управляет настольным клиентом
Пример запроса к агенту
Скомпилируй мини-программу, открой страницу списка заказов и покажи ошибки консоли с полным скриншотом страницы.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
WECHAT_DEVTOOLS_CLIобязательная- Абсолютный путь к cli.bat или cli среды WeChat DevTools.
WECHAT_PROJECT_PATHобязательная- Абсолютный путь к корню проекта мини-программы.
WECHAT_CDP_PORT- Порт CDP, если 9222 занят.
Ограничения
Сервер и навык надо ставить вместе, с версиями, которые совпадают: проверить это можно вызовом wechat_ide(action='status') и сравнением mcp_version с skill_version. В настройках WeChat DevTools нужно включить сервисный порт, иначе открытие, компиляция и превью завершаются ошибкой CLI_TIMEOUT. Если порт 9222 занят Chrome, задайте другой через WECHAT_CDP_PORT.
Начиная со Stable 2.02.2609240 встроенный MCP среды требует отдельный токен, и после обновления конфигурацию его копируют заново. Проект этот интерфейс не использует. Версии до 0.9.10 несовместимы с mcp SDK 2.0. Большая часть документации написана по-китайски, есть краткая английская версия.
Как отключить. Удалите блок wechat-devtools-mcp из конфигурации клиента и навык командой в вашем клиенте, затем при желании выполните uv tool uninstall wechat-devtools-mcp.
Частые вопросы
Как проверить, что сервер настроен правильно?
Вызовите `wechat_ide(action='status')`. Поля `cli_exists`, `project_exists` и `node_available` должны быть `true`, а `skill_version` должна совпадать с `mcp_version`. Если нет, сверьте оба пути из конфигурации и переустановите навык.
Какие клиенты подходят?
В README конфигурация описана для Claude Desktop, Claude Code, Antigravity, Kiro и Trae. Общая схема подходит любому клиенту MCP, который запускает команды через uvx.
Нужно ли ставить навык вместе с сервером?
Да, автор требует ставить оба. Сервер дает только семь сводных инструментов, а процедуры и приемы отладки лежат в навыке: `npx -y skills add WaterTian/wechat-devtools-mcp/.agents/skills/wechat-devtools`. Для клиентов вроде Trae папку навыка копируют вручную.
Чем проект отличается от встроенного MCP в WeChat DevTools 2.x?
Встроенный сервер IDE лучше подходит для открытия проекта, компиляции, загрузки и кликов. Этот проект добавляет склейку длинных скриншотов страницы, структурированные журналы CDP с историей и готовые сценарии проверки. Для версии 1.06 встроенного MCP нет, и проект работает с ней.
Работает ли сервер с WeChat DevTools 1.06?
Да. Версии 1.06.x на NW.js поддерживаются, и встроенного MCP у них нет. Среда 2.x с августа 2026 года считается Stable и содержит собственный MCP с 49 инструментами.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMobile Device MCP управляет iOS и Android: касания, ввод, скриншоты и дерево элементов, несколько устройств одновременно
MCP-сервер, который ставится на iPhone с джейлбрейком и дает агенту 46 инструментов: касания, снимки экрана, OCR, приложения, файлы, логи
Методичка для ИИ-ассистента по мини-программам WeChat: от выбора темы и регистрации до разработки, монетизации и продвижения.
MCP-сервер для управления iOS и Android: симуляторы, эмуляторы и реальные устройства через дерево доступности и скриншоты
XcodeBuildMCP (теперь MobileBuildMCP)
XcodeBuildMCP
MCP-сервер и CLI от Sentry для сборки, запуска и тестирования iOS и macOS проектов Xcode из AI-агента
Android MCP Server — управление Android через ADB
Android MCP Server
MCP-сервер на Python: агент делает снимок экрана Android-устройства, читает кликабельные элементы интерфейса и выполняет команды ADB
Коротко о README
README открывается заметкой о том, как проект соотносится со встроенным MCP среды 2.x, затем идут шесть шагов установки, таблица инструментов и действий и разделы по отладке. Документация лежит на китайском и в сокращенном английском варианте.