weapp-agent-mcp — MCP-сервер для Claude Code: установка
MCP-сервер подключает ИИ-агента к WeChat DevTools для отладки мини-программ, управления страницами и лёгких регрессионных проверок.
claude mcp add --env WEAPP_WS_ENDPOINT=<WEAPP_WS_ENDPOINT> --env WEAPP_AUTOMATOR_MODE=<WEAPP_AUTOMATOR_MODE> --env WEAPP_PROJECT_PATH=<WEAPP_PROJECT_PATH> --env WECHAT_DEVTOOLS_CLI_PATH=<WECHAT_DEVTOOLS_CLI_PATH> --env WEAPP_DEVTOOLS_PORT=<WEAPP_DEVTOOLS_PORT> --transport stdio weapp-agent-mcp -- npx -y @chaixueyuan/weapp-agent-mcpЧто делает weapp-agent-mcp
weapp-agent-mcp передаёт агенту инструменты для работы с WeChat DevTools: скриншоты, снимки страниц, навигацию, поиск элементов и действия с ними. Через page_expectVisible, page_expectRoute и похожие проверки можно осматривать интерфейс, а mp_runScenario и mp_generateScenarioReport помогают собрать короткий сценарий с Markdown-отчётом.
Сервер использует miniprogram-automator и умеет проверять соединение с DevTools и восстанавливать его через mp_healthCheck и mp_recoverConnection. Стабильные qa-*-селекторы делают такие проверки предсказуемее. Параллельные скриншоты не поддерживаются, а длинные сценарии советуют разбивать на короткие.
Перед подключением нужны WeChat DevTools с включёнными автоматизацией и сервисным портом, Node.js 18+, npm и проект мини-программы. Без этих настроек MCP-сервер не сможет управлять приложением.
Какие задачи решает
- проверить видимость элементов на странице мини-программы
- снять скриншот и получить состояние текущего экрана
- прогнать короткий сценарий после изменения интерфейса
- собрать Markdown-отчёт для проверки сценария
- восстановить соединение с WeChat DevTools
Примеры запросов агенту
- Проверь экран авторизации через
mp_screenshot, затем оцени видимость кнопки сpage_expectVisible. - Сними
page_snapshotдля текущей страницы и проверь переход по маршруту. - Запусти короткий сценарий через
mp_runScenarioи подготовь Markdown-отчёт сmp_generateScenarioReport.
Как установить weapp-agent-mcp
Командой платформы
claude mcp add --env WEAPP_WS_ENDPOINT=<WEAPP_WS_ENDPOINT> --env WEAPP_AUTOMATOR_MODE=<WEAPP_AUTOMATOR_MODE> --env WEAPP_PROJECT_PATH=<WEAPP_PROJECT_PATH> --env WECHAT_DEVTOOLS_CLI_PATH=<WECHAT_DEVTOOLS_CLI_PATH> --env WEAPP_DEVTOOLS_PORT=<WEAPP_DEVTOOLS_PORT> --transport stdio weapp-agent-mcp -- npx -y @chaixueyuan/weapp-agent-mcpВместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера
Командой платформы
codex mcp add weapp-agent-mcp --env WEAPP_WS_ENDPOINT=<WEAPP_WS_ENDPOINT> --env WEAPP_AUTOMATOR_MODE=<WEAPP_AUTOMATOR_MODE> --env WEAPP_PROJECT_PATH=<WEAPP_PROJECT_PATH> --env WECHAT_DEVTOOLS_CLI_PATH=<WECHAT_DEVTOOLS_CLI_PATH> --env WEAPP_DEVTOOLS_PORT=<WEAPP_DEVTOOLS_PORT> -- npx -y @chaixueyuan/weapp-agent-mcpВместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"weapp-agent-mcp": {
"command": "npx",
"args": [
"-y",
"@chaixueyuan/weapp-agent-mcp"
],
"env": {
"WEAPP_WS_ENDPOINT": "<WEAPP_WS_ENDPOINT>",
"WEAPP_AUTOMATOR_MODE": "<WEAPP_AUTOMATOR_MODE>",
"WEAPP_PROJECT_PATH": "<WEAPP_PROJECT_PATH>",
"WECHAT_DEVTOOLS_CLI_PATH": "<WECHAT_DEVTOOLS_CLI_PATH>",
"WEAPP_DEVTOOLS_PORT": "<WEAPP_DEVTOOLS_PORT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"weapp-agent-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@chaixueyuan/weapp-agent-mcp"
],
"env": {
"WEAPP_WS_ENDPOINT": "<WEAPP_WS_ENDPOINT>",
"WEAPP_AUTOMATOR_MODE": "<WEAPP_AUTOMATOR_MODE>",
"WEAPP_PROJECT_PATH": "<WEAPP_PROJECT_PATH>",
"WECHAT_DEVTOOLS_CLI_PATH": "<WECHAT_DEVTOOLS_CLI_PATH>",
"WEAPP_DEVTOOLS_PORT": "<WEAPP_DEVTOOLS_PORT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e WEAPP_WS_ENDPOINT=<WEAPP_WS_ENDPOINT> -e WEAPP_AUTOMATOR_MODE=<WEAPP_AUTOMATOR_MODE> -e WEAPP_PROJECT_PATH=<WEAPP_PROJECT_PATH> -e WECHAT_DEVTOOLS_CLI_PATH=<WECHAT_DEVTOOLS_CLI_PATH> -e WEAPP_DEVTOOLS_PORT=<WEAPP_DEVTOOLS_PORT> weapp-agent-mcp npx -y @chaixueyuan/weapp-agent-mcpВместо <…> подставьте свои значения. Ещё 10 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о weapp-agent-mcp
Как установить weapp-agent-mcp в Claude Code?
Выполните `claude mcp add weapp-agent-mcp -e WEAPP_AUTO_ACCOUNT=<WEAPP_AUTO_ACCOUNT> -e WEAPP_DEVTOOLS_TICKET=<WEAPP_DEVTOOLS_TICKET> -- npx -y @chaixueyuan/weapp-agent-mcp`. Затем настройте доступ к WeChat DevTools и параметры подключения.
Что делает weapp-agent-mcp?
Он даёт агенту инструменты для управления WeChat DevTools: навигации, снимков страниц, действий с элементами, проверок интерфейса и коротких сценариев.
Что нужно подготовить для работы MCP-сервера?
Нужны WeChat DevTools с включёнными автоматизацией и сервисным портом, Node.js 18+, npm и открываемый в DevTools проект мини-программы.
