wechat-devtools-mcp — MCP-сервер для Claude Code: что делает
Управляет WeChat DevTools через 7 MCP-инструментов: компилирует мини-приложения, снимает длинные скриншоты, читает логи CDP и автоматизирует тестирование.
claude mcp add --env WECHAT_DEVTOOLS_CLI=<WECHAT_DEVTOOLS_CLI> --env WECHAT_PROJECT_PATH=<WECHAT_PROJECT_PATH> --env WECHAT_CLI_TIMEOUT=<WECHAT_CLI_TIMEOUT> --env NODE_PATH=<NODE_PATH> --transport stdio wechat-devtools-mcp -- uvx wechat-devtools-mcpЧто делает wechat-devtools-mcp
Сервер оборачивает CLI WeChat DevTools в 7 инструментов: wechat_ide, wechat_build, wechat_automator, wechat_inspector, wechat_screenshot, wechat_navigate и wechat_file. С их помощью агент открывает среду разработки, собирает npm, эмулирует клики, меняет данные страниц и делает постраничные скриншоты со склейкой.
Для запуска понадобятся uv или вызов через uvx, а также включённый сервисный порт в настройках безопасности WeChat DevTools. Без включённого порта все вызовы завершатся ошибкой CLI_TIMEOUT. В конфигурации сервера обязательно передавать абсолютные пути к бинарнику CLI и корню проекта.
Разработчик подчёркивает подход «тонкий MCP + толстый скилл»: сервер отвечает за вызов команд, а сценарии сквозного тестирования вынесены в отдельный скилл wechat-devtools.
Какие задачи решает
- скомпилировать и загрузить мини-приложение через CLI
- сделать склеенный длинный скриншот интерфейса
- собрать структурированные логи CDP при переходе по страницам
- эмулировать клики и ввод текста в тестах WeChat
Примеры запросов агенту
- Проверь статус WeChat DevTools и собери проект через
wechat_build - Сделай длинный скриншот текущей страницы мини-приложения
- Запусти тест с эмуляцией клика по кнопке и прочитай логи CDP
Как установить wechat-devtools-mcp
Командой платформы
claude mcp add --env WECHAT_DEVTOOLS_CLI=<WECHAT_DEVTOOLS_CLI> --env WECHAT_PROJECT_PATH=<WECHAT_PROJECT_PATH> --env WECHAT_CLI_TIMEOUT=<WECHAT_CLI_TIMEOUT> --env NODE_PATH=<NODE_PATH> --transport stdio wechat-devtools-mcp -- uvx wechat-devtools-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from wechat-devtools-mcp <команда>
Командой платформы
codex mcp add wechat-devtools-mcp --env WECHAT_DEVTOOLS_CLI=<WECHAT_DEVTOOLS_CLI> --env WECHAT_PROJECT_PATH=<WECHAT_PROJECT_PATH> --env WECHAT_CLI_TIMEOUT=<WECHAT_CLI_TIMEOUT> --env NODE_PATH=<NODE_PATH> -- uvx wechat-devtools-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from wechat-devtools-mcp <команда>
Файл настроек
{
"mcpServers": {
"wechat-devtools-mcp": {
"command": "uvx",
"args": [
"wechat-devtools-mcp"
],
"env": {
"WECHAT_DEVTOOLS_CLI": "<WECHAT_DEVTOOLS_CLI>",
"WECHAT_PROJECT_PATH": "<WECHAT_PROJECT_PATH>",
"WECHAT_CLI_TIMEOUT": "<WECHAT_CLI_TIMEOUT>",
"NODE_PATH": "<NODE_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from wechat-devtools-mcp <команда>
Файл настроек
{
"servers": {
"wechat-devtools-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"wechat-devtools-mcp"
],
"env": {
"WECHAT_DEVTOOLS_CLI": "<WECHAT_DEVTOOLS_CLI>",
"WECHAT_PROJECT_PATH": "<WECHAT_PROJECT_PATH>",
"WECHAT_CLI_TIMEOUT": "<WECHAT_CLI_TIMEOUT>",
"NODE_PATH": "<NODE_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from wechat-devtools-mcp <команда>
Командой платформы
gemini mcp add -e WECHAT_DEVTOOLS_CLI=<WECHAT_DEVTOOLS_CLI> -e WECHAT_PROJECT_PATH=<WECHAT_PROJECT_PATH> -e WECHAT_CLI_TIMEOUT=<WECHAT_CLI_TIMEOUT> -e NODE_PATH=<NODE_PATH> wechat-devtools-mcp uvx wechat-devtools-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from wechat-devtools-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о wechat-devtools-mcp
Как установить wechat-devtools-mcp в Claude Code?
Выполните команду `claude mcp add wechat-devtools-mcp -e WECHAT_DEVTOOLS_CLI=<WECHAT_DEVTOOLS_CLI> -e WECHAT_PROJECT_PATH=<WECHAT_PROJECT_PATH> -- uvx wechat-devtools-mcp`, подставив абсолютные пути к CLI и проекту.
Зачем нужен wechat-devtools-mcp, если в WeChat DevTools 2.x есть встроенный MCP?
Встроенный сервер содержит 47 атомарных вызовов, а этот проект дополняет его склейкой длинных скриншотов, очисткой логов CDP и готовыми сценариями проверок.
Почему команды возвращают ошибку CLI_TIMEOUT?
В WeChat DevTools выключен сервисный порт. Перейдите в настройки безопасности IDE и включите опцию «Сервисный порт».