# weapp-agent-mcp

MCP-сервер подключает ИИ-агента к WeChat DevTools для отладки мини-программ, управления страницами и лёгких регрессионных проверок.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 21
- Автор: Chaixueyuan
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Chaixueyuan/weapp-agent-mcp
- Обновлён: 2026-07-01
- HTML: https://affpapa.org/nevibecode/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-сервер не сможет управлять приложением.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `WEAPP_WS_ENDPOINT`, `WEAPP_AUTOMATOR_MODE`, `WEAPP_PROJECT_PATH`, `WECHAT_DEVTOOLS_CLI_PATH`, `WEAPP_DEVTOOLS_PORT`, `WEAPP_DEVTOOLS_TIMEOUT`, `WEAPP_AUTO_ACCOUNT`, `WEAPP_DEVTOOLS_TICKET`, `WEAPP_TRUST_PROJECT`, `WEAPP_DEVTOOLS_ARGS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 сервера

## Когда брать
- проверить видимость элементов на странице мини-программы
- снять скриншот и получить состояние текущего экрана
- прогнать короткий сценарий после изменения интерфейса
- собрать Markdown-отчёт для проверки сценария
- восстановить соединение с WeChat DevTools

## Примеры запросов агенту
- Проверь экран авторизации через `mp_screenshot`, затем оцени видимость кнопки с `page_expectVisible`.
- Сними `page_snapshot` для текущей страницы и проверь переход по маршруту.
- Запусти короткий сценарий через `mp_runScenario` и подготовь Markdown-отчёт с `mp_generateScenarioReport`.

## Похожие
- [mobile-mcp](https://affpapa.org/nevibecode/mcp/mobile-mcp.md) — MCP-сервер · ★ 9946
- [mobilerun](https://affpapa.org/nevibecode/mcp/mobilerun.md) — MCP-сервер · ★ 9751
- [e2e](https://affpapa.org/nevibecode/mcp/e2e.md) — MCP-сервер · ★ 11912
- [XcodeBuildMCP](https://affpapa.org/nevibecode/mcp/xcodebuildmcp.md) — MCP-сервер · ★ 6505
- [ShipSwift](https://affpapa.org/nevibecode/mcp/shipswift.md) — MCP-сервер · ★ 3244
- [agent-device](https://affpapa.org/nevibecode/mcp/agent-device.md) — MCP-сервер · ★ 5149

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md