wechat-devtools-mcp
MCP-сервер WeChat DevTools (v0.9.15)
Обёртка CLI WeChat DevTools в виде сервиса MCP (Model Context Protocol), позволяющая ИИ в редакторе напрямую вызывать команды WeChat CLI и реализовать полный цикл разработки, тестирования, отладки и автоматизации мини-программ.
[!IMPORTANT] Проект построен по архитектуре «тонкий MCP + полный Skill»: MCP-сервер предоставляет 7 агрегированных API, а сопутствующий wechat-devtools Skill — SOP-процедуры, справочник параметров и лучшие практики. Оба компонента обязательны к совместному использованию — без Skill ИИ не сможет корректно работать с мини-программой.
Опубликован в официальный MCP Registry, поддерживает кроссплатформенную установку в один клик (Windows / macOS).
🚀 Установка и быстрое начало
Шаг 1 — Установка MCP-сервера
Рекомендуется использовать uv — он автоматически обрабатывает зависимости Python и предоставляет изолированную среду выполнения.
pip install uv # 安装 uv(如已安装可跳过)
uv tool install wechat-devtools-mcp --force # 一键安装到全局隔离环境[!WARNING] Если ранее вы устанавливали старую версию через
pip install, сначала удалите её, чтобы избежать конфликта версий:pip uninstall wechat-devtools-mcpПуть
pip install(например,Python313/Scripts/) может иметь приоритет над путёмuv tool install(~/.local/bin/), из-за чего будет запускаться старая версия. Текущую версию можно проверить по полюmcp_version, возвращаемомуwechat_ide(action='status').
[!WARNING] Совместимость версий: версии ≥0.9.11 поддерживают mcp 1.x и 2.x (объявление зависимости
mcp[cli]>=1.9,<3). Версии ≤0.9.10 несовместимы с mcp ≥2.0 (при новой установке возникает ошибкаModuleNotFoundError: mcp.server.fastmcp, см. #9) — пользователям закреплённых версий следует обновиться до ≥0.9.11 или добавить--with "mcp<2"при установке.
[!TIP]
Проверка фактически запущенной версии (≥0.9.13):
wechat-devtools-mcp --version # 零依赖打印实际安装版本;uvx 复用已装环境不自拉最新,此命令可直接确认 uv tool list | grep wechat # 离线确认已安装版本Обновление инструмента: если редактор запускает MCP-сервис, сначала завершите процесс, затем обновите:
# Bash / CMD taskkill /F /IM "wechat-devtools-mcp*" 2>/dev/null; uv tool upgrade wechat-devtools-mcp# Windows PowerShell Get-Process | Where-Object { $_.ProcessName -like "*wechat-devtools*" } | Stop-Process -Force uv tool upgrade wechat-devtools-mcpОбновление в один клик через агента:
taskkill /F /IM "wechat-devtools-mcp*" 2>/dev/null; uv tool upgrade wechat-devtools-mcp && npx -y skills add WaterTian/wechat-devtools-mcp/.agents/skills/wechat-devtools
Шаг 2 — Включение порта сервиса DevTools
[!WARNING] Необходимо включить вручную, иначе ИИ не сможет отправлять команды.
Путь: DevTools → Настройки → Параметры безопасности → Порт сервиса → Включить
💡 Проверить, включён ли порт, можно через
wechat_ide(action='status')— если возвращается ошибка подключения, порт сервиса ещё не включён.
Шаг 3 — Уточнение необходимых путей
Заранее получите следующие два абсолютных пути — они понадобятся для настройки редактора:
Путь | Пример для Windows | Пример для macOS |
CLI WeChat DevTools |
|
|
Корневой каталог проекта мини-программы |
|
|
Пользователям macOS: в JSON-конфигурации экранировать слэши (
/) не нужно; пользователям Windows нужно записывать\как\\.
Шаг 4 — Настройка редактора
Измените claude_desktop_config.json или mcp_config.json (Antigravity):
{
"mcpServers": {
"wechat-devtools": {
"command": "uvx",
"args": ["wechat-devtools-mcp"],
"env": {
"WECHAT_DEVTOOLS_CLI": "C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat",
"WECHAT_PROJECT_PATH": "D:\\Your\\Project\\Path"
}
}
}
}Отредактируйте ~/.kiro/settings/mcp.json:
{
"mcpServers": {
"wechat-devtools": {
"command": "uvx",
"args": ["wechat-devtools-mcp"],
"env": {
"WECHAT_DEVTOOLS_CLI": "C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat",
"WECHAT_PROJECT_PATH": "D:\\Your\\Project\\Path",
"PYTHONIOENCODING": "utf-8"
},
"autoApprove": [
"wechat_ide", "wechat_build", "wechat_automator", "wechat_inspector",
"wechat_screenshot", "wechat_navigate", "wechat_file"
]
}
}
}Отредактируйте ~/.codex/config.toml (глобально) или .codex/config.toml (на уровне проекта):
[mcp_servers.wechat-devtools]
command = "uvx"
args = ["wechat-devtools-mcp"]
[mcp_servers.wechat-devtools.env]
WECHAT_DEVTOOLS_CLI = "C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat"
WECHAT_PROJECT_PATH = "D:\\Your\\Project\\Path"Также можно быстро добавить через CLI:
codex mcp add wechat-devtools \
--env WECHAT_DEVTOOLS_CLI="C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat" \
--env WECHAT_PROJECT_PATH="D:\\Your\\Project\\Path" \
-- uvx wechat-devtools-mcpДобавьте новый сервер в консоли MCP:
Name:
wechat-devtoolsType:
commandCommand:
uvx wechat-devtools-mcpEnvironment Variables: добавьте
WECHAT_DEVTOOLS_CLIиWECHAT_PROJECT_PATH, как указано выше
В Windows обратную косую черту в путях нужно экранировать (
\\).
Если вы используете Claude Code для разработки в репозитории мини-программы, можно создать файл .mcp.json на уровне проекта (он автоматически следует за репозиторием и действует для всех соавторов).
Windows — .mcp.json в корне репозитория:
{
"mcpServers": {
"wechat-devtools": {
"command": "uvx",
"args": ["wechat-devtools-mcp"],
"env": {
"WECHAT_DEVTOOLS_CLI": "C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat",
"WECHAT_PROJECT_PATH": "D:\\Your\\Project\\Path"
}
}
}
}macOS — .mcp.json в корне репозитория:
{
"mcpServers": {
"wechat-devtools": {
"command": "/opt/homebrew/bin/uvx",
"args": ["wechat-devtools-mcp"],
"env": {
"PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin",
"WECHAT_DEVTOOLS_CLI": "/Applications/wechatwebdevtools.app/Contents/MacOS/cli",
"WECHAT_PROJECT_PATH": "/Users/<you>/WeChatProjects/<project>",
"NODE_PATH": "/opt/homebrew/bin/node"
}
}
}
}Три ключевых отличия для macOS:
commandдолжен использовать абсолютный путь/opt/homebrew/bin/uvx(при запуске дочерних процессов Claude CodePATHне содержит Homebrew)
env.PATHнеобходимо указывать явно (особенно важно при одновременной настройке MCP на базеnpx, таких как cloudbase / chrome-devtools — иначеnpxне найдёт Node из-за#!/usr/bin/env node)
NODE_PATHрекомендуется указывать явно как дополнительную страховку при запуске демона
При одновременной настройке нескольких MCP (cloudbase / chrome-devtools и т. д.) для каждого сервера применяется одинаковая схема: абсолютный путь в
commandиenv.PATH.
Trae v1.3.0+ поддерживает MCP. Панель ИИ → Настройки в правом верхнем углу → MCP → Добавить → Настроить вручную, вставьте приведённый ниже JSON и сохраните.
Windows:
{
"mcpServers": {
"wechat-devtools": {
"command": "uvx",
"args": ["wechat-devtools-mcp"],
"env": {
"WECHAT_DEVTOOLS_CLI": "C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat",
"WECHAT_PROJECT_PATH": "D:\\Your\\Project\\Path"
}
}
}
}macOS:
{
"mcpServers": {
"wechat-devtools": {
"command": "/opt/homebrew/bin/uvx",
"args": ["wechat-devtools-mcp"],
"env": {
"PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin",
"WECHAT_DEVTOOLS_CLI": "/Applications/wechatwebdevtools.app/Contents/MacOS/cli",
"WECHAT_PROJECT_PATH": "/Users/<you>/WeChatProjects/<project>",
"NODE_PATH": "/opt/homebrew/bin/node"
}
}
}
}Можно также отредактировать файл конфигурации напрямую:
Windows:
%APPDATA%\Trae\User\globalStorage\mcp.jsonmacOS:
~/Library/Application Support/Trae/User/globalStorage/mcp.json
[!IMPORTANT] В окне чата обязательно выберите агента «Builder with MCP» — обычные агенты не вызывают инструменты MCP. Рекомендуется также установить wechat-devtools Skill (Шаг 5), чтобы ИИ вызывал инструменты в порядке SOP.
Шаг 5 — Установка Skill (обязательно)
[!IMPORTANT] Этот MCP обязательно должен использоваться вместе с wechat-devtools Skill. Skill содержит все SOP-процедуры, справочник параметров и руководство по устранению неполадок, необходимые ИИ для работы с мини-программой. Без установленного Skill ИИ сможет вызывать только «голые» API и не сможет автоматически выполнять стандартизированные процедуры тестирования и отладки.
Способ 1: npx skills add (для пользователей Claude Code)
npx -y skills add WaterTian/wechat-devtools-mcp/.agents/skills/wechat-devtoolsБудет установлено в ~/.claude/skills/, Claude Code загрузит автоматически.
Способ 2: вручную в .agents/skills/ (для клиентов, загружающих из .agents/skills/, например Trae)
Выполните в корневом каталоге проекта мини-программы:
git clone --depth 1 https://github.com/WaterTian/wechat-devtools-mcp.git .wdm-tmp
mkdir -p .agents/skills
cp -r .wdm-tmp/.agents/skills/wechat-devtools .agents/skills/
rm -rf .wdm-tmpСтруктура каталогов после завершения:
your-project/
└── .agents/skills/
└── wechat-devtools/
├── SKILL.md # 主指令文件(SOP + 能力映射 + 红线规则)
└── references/
└── tool_reference.md # 7 个聚合 API 完整参数参考[!TIP] Пользователям Trae: убедитесь, что переключатель Настройки → Навыки и команды → Включить каталог навыков .agents включён (по умолчанию включён). После сохранения обновите страницу — в разделе «Навыки → Проект» появится
wechat-devtools.
Related MCP server: harmony-mcp
🛠️ Обзор инструментов
MCP-сервер предоставляет 7 агрегированных инструментов, покрывающих весь жизненный цикл мини-программы:
Инструмент | Функция | Поддерживаемые action |
| Управление жизненным циклом IDE |
|
| Сборка и публикация |
|
| Автоматизированное взаимодействие |
|
| Сбор журналов времени выполнения |
|
| Снимки экрана (склейка длинных изображений) | — |
| Переход на страницу и сбор CDP-журналов | — |
| Чтение файлов проекта |
|
Для управления облачными функциями и облачной базой данных используйте CloudBase MCP (
manageFunctions/readNoSqlDatabaseContentи т. д.) — функциональность полнее и нет зависимости от IDE.wechat_cloudотключён начиная с v0.9.5.
🧠 Содержание Skill
Skill позволяет ИИ после получения команды на естественном языке автоматически подбирать и выполнять стандартизированные процедуры:
Что вы говорите | Процедура, выполняемая ИИ |
«Проверь все страницы на ошибки» | SOP D — проверка всех страниц |
«Нажми кнопку входа, сделай скриншот» | SOP B — отладка UI |
«Страница белая, помоги разобраться» | SOP C — устранение неполадок |
«Замокай платёжный интерфейс, протестируй платёжный процесс» | SOP E — интеграционное тестирование с Mock |
«Протестируй страницу деталей, как называется параметр» | SOP G — тестирование подстраниц |
«Сравни, совпадают ли баллы на разных страницах» | SOP I — проверка данных между страницами |
Что входит в Skill
9 SOP-процедур — инициализация, отладка UI, устранение неполадок, проверка всех страниц, интеграционное тестирование с Mock, сетевая отладка и адаптация UI, тестирование подстраниц, проверка данных между страницами, параллельное сравнение данных
Словарь сопоставления возможностей — быстрый индекс 7 агрегированных инструментов × все action
Стратегия поэтапного поиска CDP — concise → full, два этапа для контроля расхода токенов
Полный справочник параметров — обязательные/необязательные параметры каждого action, примеры возвращаемых значений, часто используемые шаблоны
Руководство по устранению неполадок — распространённые коды ошибок и способы их исправления
Способ установки см. в Шаг 5 — Установка Skill
💡 Переменные окружения
Имя переменной | Описание | Значение по умолчанию | Обязательна |
| Путь к CLI WeChat DevTools | — | Да |
| Абсолютный путь к проекту мини-программы по умолчанию | — | Да |
| Тайм-аут команд CLI (секунды) |
| Нет |
| Путь к исполняемому файлу Node.js |
| Нет |
❓ Часто задаваемые вопросы
Самая частая причина: не включён «порт сервиса» WeChat DevTools.
Откройте Настройки → Безопасность → Порт сервиса и включите его. После включения перезапуск IDE не требуется — ИИ сразу восстановит подключение.
Если вы открыли DevTools вручную, он может не прослушивать порт отладки. Закройте DevTools и дайте ИИ выполнить wechat_ide(action='open', cdp_enabled=True) для запуска в режиме отладки.
MCP-сервис в редакторе всё ещё работает. См. подсказку по обновлению под Шагом 1 — сначала завершите процесс, затем обновите.
Возможно, старая версия, установленная через pip install, имеет более высокий приоритет. Выполните pip uninstall wechat-devtools-mcp для удаления старой версии, затем проверьте через wechat_ide(action='status'), что поле mcp_version содержит актуальную версию.
Убедитесь, что в env конфигурации редактора в WECHAT_DEVTOOLS_CLI указан абсолютный путь:
Windows: используйте двойную обратную косую черту (например,
C:\\...\\cli.bat)macOS: стандартный путь
/Applications/wechatwebdevtools.app/Contents/MacOS/cli, слэши экранировать не нужно
При запуске MCP из GUI-клиента (например, Claude Desktop) PATH может не содержать /opt/homebrew/bin. Начиная с MCP v0.9.6 автоматически проверяется стандартный путь Homebrew; если это не помогло, укажите его явно в env:
"NODE_PATH": "/opt/homebrew/bin/node"📋 История версий
版本 | 说明 |
0.9.15 | Адаптация под DevTools 2.x (Electron) + исправление давнего сбоя сбора CDP: DevTools 2.x перешёл на Electron (1.06.x Stable по-прежнему на NW.js, двойная совместимость без замены). Путь запуска на macOS определяется автоматически по наличию |
0.9.14 | Исправление путей чтения файлов + исправление неработающих параметров: |
0.9.13 | Ранний выход по |
0.9.12 | Версия в ответе рукопожатия + верхняя граница зависимостей: в mcp 2.x |
0.9.11 | Совместимость с mcp 2.0.0: официальный Python SDK MCP 2.0 (выпущен 2026-07-28) удалил |
0.9.10 | Исправление тихого сбоя page_path: screenshot.js после навигации проверяет соответствие пути страницы, при отсутствии суффикса |
0.9.9 | Исправление перезапуска мини-программы после скриншота: в screenshot.js навигация для не-TabBar страниц изменена с |
0.9.8 | Исправление стабильности подключения automator: проверка работоспособности |
0.9.7 | Исправление остаточных осиротевших процессов daemon: в daemon.js добавлен watchdog родительского процесса, каждые 5 секунд проверяется |
0.9.6 | Адаптация под macOS: кроссплатформенный запуск в режиме |
0.9.5 | Исправление скрытого бага с вечно неудачной проверкой работоспособности compile (в ui_debug.js нет action |
0.9.4 | Исправлено, что switchTab не срабатывал (заменено на |
Версия | Описание |
0.9.3 | В status добавлено поле |
0.9.2 | Исправлен таймаут navigate после compile: добавлена защита таймаута 3s при проверке здоровья соединения daemon; после compile автоматически инвалидируется старое кэшированное соединение и выполняется переподключение; при опросе currentPage в navigate добавлен отдельный таймаут 2s на каждый вызов; различаются коды ошибок HEALTH_CHECK_TIMEOUT и CONNECTION_ERROR |
0.9.1 | Исправлен сбой AttributeError при cdp_enabled=true; добавлен сбор ошибок времени выполнения WXML (после compile CDP автоматически перехватывает предупреждения, такие как template not found) |
0.9.0 | Постоянная архитектура Node daemon: один постоянный процесс daemon, обмен по протоколу NDJSON, WS-соединения переиспользуются по портам; один daemon.bundle.js заменяет 8 отдельных bundle; задержка вызова инструментов снижена с 500ms+ до ~3ms; после compile daemon автоматически пересоздаёт соединение без разрывов |
0.8.0 | Автоматическое переподключение automator после compile; navigate автоматически определяет страницы TabBar и использует switchTab; в screenshot добавлены параметры full_page/scroll_top/page_path и режим снимка области просмотра; в page_data добавлен опрос expected_path для защиты от устаревших данных; динамический шаг при склейке длинных изображений исправляет пропуски содержимого; node_bridge унифицирует повторные попытки при разрыве соединения + интервал вызова 500ms; проверка порта start увеличена до 20 раз |
0.7.0 | Исправлена область видимости переменных navigate (currentPageTimeout); evaluate поддерживает объявления (const/let/var fallback); call_method возвращает путь текущей страницы; automator start использует опрос порта вместо слепого ожидания; в SKILL.md добавлены принципы эффективности, уровни восстановления, методы перехода между страницами, 6 записей о неисправностях |
0.6.0 | navigate поддерживает параметр query (fallback при таймауте reLaunch); фильтрация шума при запуске CDP (подавление console.assert/__route__/ide:// + защита от ошибок WXML); возвращаемое значение compile разделено на три категории + предупреждение о неработоспособности automator; повторные попытки опроса currentPage в navigate; настраиваемые таймауты |
0.5.1 |
|
0.5.0 | Всесторонняя оптимизация Skill SOP: добавлены SOP I/J; добавлены проверка AppID и валидация path; фильтрация шума CDP; исправлено нечёткое сопоставление при склейке скриншотов |
0.4.1 | Переписана склейка длинных страниц скриншотов: обнаружение фиксированных областей, адаптация к DPR, динамический расчёт перекрытий |
0.4.0 | Улучшены логи CDP, автоматическая проверка развёртывания облачных функций, интеллектуальная диагностика navigate, добавлены SOP G/H |
0.3.0 | Крупный рефакторинг: 44 инструмента объединены в 8 API; логи CDP v2; добавлена база знаний SKILL.md |
0.2.6 | В README добавлено описание конфигурации OpenAI Codex |
0.2.5 | Добавлено описание конфигурации редактора Kiro |
0.2.4 | Исправлена склейка скриншотов при прокрутке: |
0.2.3 | Оптимизация пакета: исключён исходный код |
0.2.2 | Скрипты Node.js переведены в режим bundle-only |
0.2.1 | Обновление версии и улучшение документации |
0.2.0 | navigate переведён на сбор высококачественных логов CDP |
0.1.9 | Исправлена проблема с кодировкой UTF-8 (кракозябры) |
0.1.8 | Исправлена ошибка UnicodeDecodeError для китайских путей в Windows |
0.1.7 | Добавлены пресеты наборов инструментов core/full; добавлен MCP_DOC.md |
0.1.6 |
|
0.1.5 | Исправлена проблема блокировки stdio в Windows |
0.1.4 | Добавлены функции: логи CDP, скриншоты, автоматизация и др. |
0.1.3 | Начальная версия |
Справочная документация
Лицензия
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables AI assistants to automate WeChat Developer Tools for mini programs, allowing navigation, inspection, and manipulation of pages and components through the miniprogram-automator API.2767174MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that enables AI assistants to interact with WeChat Mini Programs, allowing developers to publish versions, analyze package size, diagnose compilation errors, and manage projects via natural language.783MIT
- AlicenseAqualityAmaintenanceMCP server for WeChat Mini Program debugging and automation, enabling agents to perform UI operations, screenshots, and regression testing through natural language commands.4417914MIT
- AlicenseNot gradedqualityDmaintenanceConnects WeChat Mini Program tooling to MCP and automation workflows. Provides scripts for opening, previewing, and uploading projects, as well as automator smoke tests.1MIT
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server for Hailuo (MiniMax) AI video generation
MCP connector that lets ChatGPT list, search, and run your Apple Shortcuts via a local Mac agent
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/WaterTian/wechat-devtools-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server