# wechat-devtools-mcp

Управляет WeChat DevTools через 7 MCP-инструментов: компилирует мини-приложения, снимает длинные скриншоты, читает логи CDP и автоматизирует тестирование.

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

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `WECHAT_DEVTOOLS_CLI`, `WECHAT_PROJECT_PATH`, `WECHAT_CLI_TIMEOUT`, `NODE_PATH` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

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

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

### Cursor

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

### GitHub Copilot

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

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

## Когда брать
- скомпилировать и загрузить мини-приложение через CLI
- сделать склеенный длинный скриншот интерфейса
- собрать структурированные логи CDP при переходе по страницам
- эмулировать клики и ввод текста в тестах WeChat

## Примеры запросов агенту
- Проверь статус WeChat DevTools и собери проект через `wechat_build`
- Сделай длинный скриншот текущей страницы мини-приложения
- Запусти тест с эмуляцией клика по кнопке и прочитай логи CDP

## Похожие
- [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