wechat-devtools-mcp

wechat-devtools-mcp — MCP-сервер сообщества (автор — WaterTian). Автоматизация разработки и тестирования в WeChat DevTools. Ставится через pip или через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
WaterTian
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
Не указаны

Уровень риска: high

Запускает CLI инструментов разработчика, выполняет код в мини-программе, может загружать её в WeChat.

Настройка клиентов

codex
{
    "code": "[mcp_servers.wechat-devtools-mcp]\ncommand = \"uvx\"\nargs = [\"wechat-devtools-mcp\"]\n\n[mcp_servers.wechat-devtools-mcp.env]\nWECHAT_DEVTOOLS_CLI = \"C:\\\\Program Files (x86)\\\\Tencent\\\\微信web开发者工具\\\\cli.bat\"\nWECHAT_PROJECT_PATH = \"D:\\\\Your\\\\Project\\\\Path\"",
    "file": "~/.codex/config.toml",
    "lang": "toml",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

wechat-devtools-mcp — MCP-сервер, который оборачивает «Инструменты разработчика WeChat» (WeChat DevTools), чтобы ИИ в редакторе сам проходил полный цикл работы над мини-программой WeChat: сборку, предпросмотр, отладку и автоматическое тестирование. Работает на Windows и macOS, сервер есть в официальном реестре MCP.

Принцип проекта — «тонкий MCP и толстый навык»: сервер даёт всего семь агрегированных инструментов, а порядок действий и лучшие практики описаны в сопутствующем навыке wechat-devtools. Ставить их нужно вместе.

Инструмент Назначение
wechat_ide Жизненный цикл IDE и диагностика: открыть, войти, проверить вход, закрыть, статус
wechat_build Сборка и публикация: компиляция, предпросмотр, загрузка, сборка npm, очистка кэша
wechat_automator Автоматизация: нажатия, ввод, данные страниц, вызовы методов и API, подмена API, выполнение кода, хранилище
wechat_inspector Сбор журналов: консоль и CDP
wechat_screenshot Склейка длинных скриншотов страницы
wechat_navigate Переход на страницу со сбором журналов CDP
wechat_file Чтение файлов проекта и списка страниц

С версии 2.x у WeChat DevTools есть встроенный официальный MCP-сервер. README описывает их как взаимодополняющие: для открытия проекта, сборки и загрузки лучше официальный, а этот проект даёт склейку длинных скриншотов, структурированные журналы CDP, сценарии навыка и поддержку старой версии 1.06.x.

Кому подойдёт

  • Разработчикам мини-программ WeChat, которые хотят поручить ИИ сборку, проверку и отладку.
  • Тестировщикам: автоматизированные проверки страниц и сбор журналов.
  • Командам со старыми проектами на DevTools 1.06.x, где встроенного MCP нет.

Похожие серверы — в категории разработка.

Установка

Нужны Python 3.10+ (uv подготовит окружение сам), Node.js 18+ и WeChat DevTools 2.x или 1.06.x. Установите сервер: uv tool install wechat-devtools-mcp. В DevTools включите «Настройки → Безопасность → Порт сервиса», иначе сборка и предпросмотр будут завершаться ошибкой CLI_TIMEOUT. Подготовьте два абсолютных пути — к CLI инструментов разработчика и к корню мини-программы. Затем установите навык: npx -y skills add WaterTian/wechat-devtools-mcp/.agents/skills/wechat-devtools.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

{
  "mcpServers": {
    "wechat-devtools-mcp": {
      "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"
      }
    }
  }
}

JSON-конфиг подходит для claude_desktop_config.json в Claude Desktop и для .mcp.json в корне репозитория в Claude Code. Конфиг Codex кладётся в ~/.codex/config.toml. В Windows обратные слеши в JSON удваиваются. Если порт 9222 занят Chrome, добавьте переменную WECHAT_CDP_PORT со значением 9333.

Проверка

Вызовите wechat_ide с действием status: поля cli_exists, project_exists, node_available и service_port_enabled должны быть true, а версия навыка — совпадать с версией сервера.

Примеры задач

Скомпилируй мини-программу, открой страницу заказа и сделай длинный скриншот.
Собери журналы консоли при переходе на страницу корзины и найди ошибки.

Риски

  • Публикация. Действие upload загружает мини-программу в WeChat от имени вашего аккаунта разработчика.
  • Выполнение кода. Автоматизация выполняет код в среде мини-программы, вызывает её методы и API, меняет данные и хранилище.
  • Файлы и запуск программ. Сервер читает файлы проекта и запускает CLI инструментов разработчика.
  • Автоподтверждение. README показывает, как разрешить все инструменты без подтверждения в Kiro, — включайте это осознанно.

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

Чем отличается от встроенного MCP в DevTools 2.x?

Встроенный сервер лучше для сборки и загрузки, а этот даёт склейку длинных скриншотов, структурированные журналы CDP, сценарии навыка и поддержку версии 1.06.x.

Обязателен ли навык?

Да, README требует ставить сервер и навык вместе.

Почему всё время ошибка CLI_TIMEOUT?

Не включён порт сервиса в настройках безопасности DevTools.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

commands

Сервер из UI-TARS-desktop для запуска произвольных команд.

Риск: medium Лицензия: Apache-2.0 ★ 39 555

Windows-MCP

Управление компьютером с Windows: окна, приложения, ввод и чтение экрана.

Риск: high Лицензия: MIT ★ 11 608

agent-device

Слой управления мобильными, веб-, ТВ- и десктопными приложениями для агентов.

Риск: medium Лицензия: MIT ★ 5 295

Источники