Wechat DevTools MCP

Name: Wechat DevTools MCP
Author: WaterTian

von WaterTianVersion 0.9.21i★ 166iLäuft auf deinem Computer

Name in der Registryio.github.WaterTian/wechat-devtools-mcp

So installierst du es

What it does

MCP Server for WeChat DevTools CLI - Automate development & testing with 7 aggregated APIs.

Connects Läuft auf deinem Computer
Account or key Needs WECHAT_DEVTOOLS_CLI, WECHAT_PROJECT_PATH
Category Entwicklertools

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 13. Nov. 2026

Zuerst: Welche KI nutzt du?

ClaudeWeb · App · HandyChatGPTWebClaude CodeTerminalCursorCode-EditorVS CodeCode-EditorAndereAndere Apps

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Wechat DevTools MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Python (uv) installieren
Nur einmal; gilt für alle Server, die Python (uv) brauchen
Download-Seite von Python (uv) öffnen ↗
Erledigt
Bei Wechat DevTools MCP registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Erledigt
Einstellungsdatei der Claude-Desktop-App öffnen
SettingsDeveloperEdit Config
Erledigt

Diese Einstellungen einfügen und speichern

{
  "mcpServers": {
    "wechat-devtools": {
      "command": "uvx",
      "args": [
        "wechat-devtools-mcp"
      ],
      "env": {
        "WECHAT_DEVTOOLS_CLI": "your-value",
        "WECHAT_PROJECT_PATH": "your-value",
        "WECHAT_CLI_TIMEOUT": "your-value",
        "NODE_PATH": "your-value",
        "WECHAT_CDP_PORT": "your-value",
        "WECHAT_AUTOMATOR_READY_TIMEOUT": "your-value"
      }
    }
  }
}

Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

Erledigt

Claude beenden und neu öffnen
Erledigt
Ausprobieren
Nutze Wechat DevTools MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache
✓ Wenn Claude sagt, dass es Wechat DevTools MCP nutzt, oder ein Werkzeug von Wechat DevTools MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Wechat DevTools MCP noch nicht verbinden

Wechat DevTools MCP läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die Wechat DevTools MCP verbinden kann

Schritte für Claude →Du brauchst einen Schlüssel von Wechat DevTools MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Schritte für Claude Code →Du brauchst einen Schlüssel von Wechat DevTools MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
Schritte für Cursor →Du brauchst einen Schlüssel von Wechat DevTools MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
Schritte für VS Code →Du brauchst einen Schlüssel von Wechat DevTools MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

B · Andere in Entwicklertools, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Sentry✓ ChatGPT
Compiler Explorer✓ ChatGPT
GitDiagram✓ ChatGPT

Klappt mit Claude Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Wechat DevTools MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

Python (uv) installieren
Nur einmal; gilt für alle Server, die Python (uv) brauchen
Download-Seite von Python (uv) öffnen ↗
Erledigt
Bei Wechat DevTools MCP registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Erledigt
Terminal öffnen
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
Erledigt

Diesen Befehl einfügen und Enter drücken

claude mcp add --scope user wechat-devtools --env WECHAT_DEVTOOLS_CLI=your-value --env WECHAT_PROJECT_PATH=your-value --env WECHAT_CLI_TIMEOUT=your-value --env NODE_PATH=your-value --env WECHAT_CDP_PORT=your-value --env WECHAT_AUTOMATOR_READY_TIMEOUT=your-value -- uvx wechat-devtools-mcp

Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

Erledigt

/mcp in Claude Code eingeben
Wechat DevTools MCP sollte in der Liste als verbunden erscheinen
Erledigt
Ausprobieren
Nutze Wechat DevTools MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache
✓ Wenn Claude Code sagt, dass es Wechat DevTools MCP nutzt, oder ein Werkzeug von Wechat DevTools MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Wechat DevTools MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

Python (uv) installieren
Nur einmal; gilt für alle Server, die Python (uv) brauchen
Download-Seite von Python (uv) öffnen ↗
Erledigt
Bei Wechat DevTools MCP registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Erledigt
Mit diesem Button Cursor öffnen
In Cursor öffnen
Cursor fragt nach einer Bestätigung; klicke Install
Erledigt
Schlüssel eintragen
In den Einstellungen von Wechat DevTools MCP ist WECHAT_DEVTOOLS_CLI, WECHAT_PROJECT_PATH, WECHAT_CLI_TIMEOUT, NODE_PATH, WECHAT_CDP_PORT, WECHAT_AUTOMATOR_READY_TIMEOUT leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Erledigt
KI-Chat in Cursor im Agent-Modus öffnen
Erledigt
Ausprobieren
Nutze Wechat DevTools MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache
✓ Wenn Cursor sagt, dass es Wechat DevTools MCP nutzt, oder ein Werkzeug von Wechat DevTools MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Wechat DevTools MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Python (uv) auf deinem Computer (nur einmal)

Python (uv) installieren
Nur einmal; gilt für alle Server, die Python (uv) brauchen
Download-Seite von Python (uv) öffnen ↗
Erledigt
Bei Wechat DevTools MCP registrieren und Schlüssel erstellen
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Erledigt
Mit diesem Button VS Code öffnen
In VS Code öffnen
VS Code fragt nach einer Bestätigung; klicke Install
Erledigt
Schlüssel eintragen
In den Einstellungen von Wechat DevTools MCP ist WECHAT_DEVTOOLS_CLI, WECHAT_PROJECT_PATH, WECHAT_CLI_TIMEOUT, NODE_PATH, WECHAT_CDP_PORT, WECHAT_AUTOMATOR_READY_TIMEOUT leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Erledigt
KI-Chat in VS Code im Agent-Modus öffnen
Erledigt
Ausprobieren
Nutze Wechat DevTools MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache
✓ Wenn VS Code sagt, dass es Wechat DevTools MCP nutzt, oder ein Werkzeug von Wechat DevTools MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Wechat DevTools MCP nutzen💬 Diskussion →

Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user wechat-devtools --env WECHAT_DEVTOOLS_CLI=your-value --env WECHAT_PROJECT_PATH=your-value --env WECHAT_CLI_TIMEOUT=your-value --env NODE_PATH=your-value --env WECHAT_CDP_PORT=your-value --env WECHAT_AUTOMATOR_READY_TIMEOUT=your-value -- uvx wechat-devtools-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "wechat-devtools": {
      "command": "uvx",
      "args": [
        "wechat-devtools-mcp"
      ],
      "env": {
        "WECHAT_DEVTOOLS_CLI": "your-value",
        "WECHAT_PROJECT_PATH": "your-value",
        "WECHAT_CLI_TIMEOUT": "your-value",
        "NODE_PATH": "your-value",
        "WECHAT_CDP_PORT": "your-value",
        "WECHAT_AUTOMATOR_READY_TIMEOUT": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "wechat-devtools": {
      "command": "uvx",
      "args": [
        "wechat-devtools-mcp"
      ],
      "env": {
        "WECHAT_DEVTOOLS_CLI": "your-value",
        "WECHAT_PROJECT_PATH": "your-value",
        "WECHAT_CLI_TIMEOUT": "your-value",
        "NODE_PATH": "your-value",
        "WECHAT_CDP_PORT": "your-value",
        "WECHAT_AUTOMATOR_READY_TIMEOUT": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "wechat-devtools": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "wechat-devtools-mcp"
      ],
      "env": {
        "WECHAT_DEVTOOLS_CLI": "your-value",
        "WECHAT_PROJECT_PATH": "your-value",
        "WECHAT_CLI_TIMEOUT": "your-value",
        "NODE_PATH": "your-value",
        "WECHAT_CDP_PORT": "your-value",
        "WECHAT_AUTOMATOR_READY_TIMEOUT": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

WECHAT_DEVTOOLS_CLI erforderlich env
微信开发者工具 CLI 路径。Windows: C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat；macOS: /Applications/wechatwebdevtools.app/Contents/MacOS/cli
WECHAT_PROJECT_PATH erforderlich env
默认小程序项目绝对路径，例如 D:\Projects\MyMiniApp
WECHAT_CLI_TIMEOUT env
CLI 命令超时时间（秒）
NODE_PATH env
Node.js 可执行文件路径
WECHAT_CDP_PORT env
CDP 调试端口默认值；9222 被 Chrome 占用时设为 9333
WECHAT_AUTOMATOR_READY_TIMEOUT env
automator start 等待首次应答的秒数

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

GitHub-Sterne i: 166
Downloads pro Wochei: 879/Wo.
Lizenz i: MIT
Verbindung: Läuft auf deinem Computer
Transport: stdio
Neueste Versioni: 0.9.21
Kategoriei: Entwicklertools
In der Registry veröffentlichti: 9. Nov. 2026
Code zuletzt geänderti: 9. Nov. 2026
Entwickler: WaterTian
Pakete: pypi: wechat-devtools-mcp
Repo: WaterTian/wechat-devtools-mcp
Registry-Status: Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 14. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto WaterTian bestätigt, dem das Repo gehört
✓ Bestanden
Wird noch gepflegt
Code zuletzt geändert: vor 5 Tagen
✓ Bestanden
Hat eine Lizenz
Nutzt MIT
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Mit Google anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Mit Google anmelden, um zu bewerten

Im Vergleich mit anderen in Entwicklertoolsi

Mehr Sterne als 97 % der anderen 5860 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 87 % der anderen 5860 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 5860 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Wechat DevTools MCP sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: WECHAT_DEVTOOLS_CLI, WECHAT_PROJECT_PATH

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 5 Tagen geändert, und die neueste Version (0.9.21) kam vor 5 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv) auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: REA, GitHub, Serena MCP: the IDE for your agent

Andere in derselben Kategorie

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

REA

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

von morlutoWeit verbreitet↓ 388.706/Wo.★ 455.411Aktualisiert vorgestern

Läuft auf deinem Computer

Installieren

GitHub

Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

von githubWeit verbreitet★ 34.443Aktualisiert vor 11 Tagen

Computer oder Cloud

Installieren

Serena MCP: the IDE for your agent

A powerful toolkit for coding, providing semantic retrieval and editing capabilities.

von oraiosWeit verbreitet↓ 35.170/Wo.★ 31.336Aktualisiert vor 6 Monaten

Läuft auf deinem Computer

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

微信开发者工具 MCP Server (v0.9.20)

把微信开发者工具封装为 MCP 服务，让编辑器里的 AI 直接完成小程序的编译、预览、调试、自动化测试闭环。Windows / macOS，已上架官方 MCP Registry。

[!IMPORTANT]

「瘦 MCP + 胖 Skill」：MCP Server 只提供 7 个聚合工具，操作流程与最佳实践都在配套的 wechat-devtools Skill 里。两者必须一起装。

🤝 与官方能力的关系

微信开发者工具 2.x 自 2026-08-18 起为官方 Stable（1.06 已下架），IDE 内建 MCP Server（47 个原子工具，其中 2 个已废弃）。两者互补，不是替代：

场景	用谁
打开项目 / 编译 / 预览 / 上传 / 点击输入 / 云开发	2.x 优先官方内建 MCP（`wechat_ide(action='status')` 的 `official_mcp.available` 为 `true` 即可用）
长图拼接截图（固定头尾识别，拍不全如实上报）	本项目。官方只截视口并压到长边 1280 JPEG
CDP 结构化日志（回放采集前的历史、按页面归类、去噪）	本项目。官方只读缓存
任务级 SOP（一句话跑完巡检 / 异常排查 / 跨页面校验）	本项目 Skill
存量 1.06.x（NW.js）	本项目继续兼容；官方内建 MCP 仅 2.x 有

⚠ 官方 IDE 把自家 bridge 注册为 wechat-devtools。本文示例统一用 `wechat-devtools-mcp` 避免撞名；旧名配置仍可用，只在同一 agent 同时接入两者时才需区分。

🚀 快速开始

前置条件：Python ≥ 3.10（uv 会自动准备）、Node.js ≥ 18（daemon 依赖 puppeteer-core / jimp）、微信开发者工具 2.x 或 1.06.x。

Step 1 — 安装 MCP Server

pip install uv                                           # 或 brew install uv；已装可跳过

uv tool install wechat-devtools-mcp # 首次安装 uv tool install wechat-devtools-mcp --force --refresh # 升级：--refresh 刷新索引缓存，否则可能装回旧版 wechat-devtools-mcp --version # 确认实际运行版本

[!WARNING]

曾用 pip install 装过旧版的，先 pip uninstall wechat-devtools-mcp，否则旧路径优先于 uv。

≤0.9.10 与 mcp SDK ≥2.0 不兼容（报 ModuleNotFoundError: mcp.server.fastmcp），请升到 ≥0.9.11。

升级前先停掉编辑器里正在跑的 MCP 进程（重启编辑器即可）。用 uvx 配置的客户端会复用已缓存的环境、不会自动升级：跑一次 uvx --refresh wechat-devtools-mcp --version 刷新，或在 args 里锁定版本 wechat-devtools-mcp==X.Y.Z。

Step 2 — 开启开发者工具服务端口

开发者工具 → 设置 → 安全设置 → 服务端口 → 开启。不开则 open / compile / preview 等走 CLI 的操作全部报 CLI_TIMEOUT。

Step 3 — 准备两个绝对路径

路径	Windows	macOS
开发者工具 CLI	`C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat`	`/Applications/wechatwebdevtools.app/Contents/MacOS/cli`
小程序项目根目录	`D:\MyProjects\mini-app`	`/Users/ /Projects/mini-app`

JSON 里 Windows 路径的 \ 要写成 \\；macOS 的 / 不用转义。

Step 4 — 编辑器配置

标准配置（Claude Desktop / Antigravity / Kiro / Trae / Claude Code .mcp.json 通用）：

"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" } } } }

9222 常年被 Chrome 等占用的机器，在 env 里再加一行 "WECHAT_CDP_PORT": "9333"。

编辑器	配置位置	差异
Claude Desktop / Antigravity	`claude_desktop_config.json` / `mcp_config.json`	无
Claude Code（项目级）	仓库根目录 `.mcp.json`	`uvx` 走终端 PATH 即可。若编辑器是 GUI 启动（桌面版）报找不到 `uvx` / `node`，`command` 改绝对路径 `/opt/homebrew/bin/uvx`，并在 `env` 加 `"PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"` 与 `"NODE_PATH": "/opt/homebrew/bin/node"`
Kiro	`~/.kiro/settings/mcp.json`	可加 `"autoApprove": ["wechat_ide","wechat_build","wechat_automator","wechat_inspector","wechat_screenshot","wechat_navigate","wechat_file"]`
Trae ≥1.3	AI 面板 → 设置 → MCP → 手动配置；或 `%APPDATA%\Trae\User\globalStorage\mcp.json` / `~/Library/Application Support/Trae/User/globalStorage/mcp.json`	聊天须选 Builder with MCP 智能体；macOS 报找不到 `uvx` 时同上改绝对路径
Cursor / VS Code	MCP 面板新增 server	Name `wechat-devtools-mcp`，Command `uvx wechat-devtools-mcp`，环境变量同上
OpenAI Codex	`~/.codex/config.toml`	TOML，见下

[mcp_servers.wechat-devtools-mcp]

command = "uvx" args = ["wechat-devtools-mcp"]

[mcp_servers.wechat-devtools-mcp.env] WECHAT_DEVTOOLS_CLI = "C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat" WECHAT_PROJECT_PATH = "D:\\Your\\Project\\Path"

Step 5 — 安装 Skill（必须）

npx -y skills add WaterTian/wechat-devtools-mcp/.agents/skills/wechat-devtools

不走 npx skills 的客户端（如 Trae）：把仓库的 .agents/skills/wechat-devtools/ 整个复制到小程序项目的 .agents/skills/ 下即可。Skill 含 9 条 SOP、7 工具全 action 速查、CDP 渐进排查策略与故障手册，详见 SKILL.md。

Step 6 — 自检

在编辑器里调一次 wechat_ide(action='status')，下面几项都符合再开工：

字段	期望	不符时
`cli_exists` / `project_exists` / `node_available`	`true`	核对 Step 3 的两个路径；安装 Node.js ≥ 18
`service_port_enabled`	`true`	见 Step 2
`cdp_port_occupant.kind`	`none` 或 `ide`	`foreign` 表示端口被别的浏览器占着，设 `WECHAT_CDP_PORT=9333`
`skill_version`	等于 `mcp_version`	重跑 Step 5 更新 skill 副本

🛠️ 工具箱

工具	用途	action / 关键参数
`wechat_ide`	IDE 生命周期与环境诊断	`open` `login` `is_login` `close` `quit` `status`
`wechat_build`	构建与发布	`compile` `preview` `upload` `build_npm` `cache_clean`
`wechat_automator`	自动化交互与运行时查询	`start` `tap` `input` `element_info` `set_data` `call_method` `call_wx` `mock_wx` `evaluate` `page_stack` `page_data` `system_info` `storage`
`wechat_inspector`	运行时日志采集	`console` `cdp`
`wechat_screenshot`	长图拼接截图	`full_page` `page_path` `scroll_top`
`wechat_navigate`	跳转并采集 CDP 日志	`page_path`
`wechat_file`	项目文件读取	`project_info` `list_pages` `read_page` `read_file`

动作遇到 automator 连接失败会自动 start 一次并重试（返回 auto_recovered）；open 成功后 cdp_port 在同一会话内自动沿用，其它工具不必再传。完整参数见 MCP_DOC.md。云函数与云数据库请用 CloudBase MCP。

💡 环境变量

变量	说明	默认
`WECHAT_DEVTOOLS_CLI`	开发者工具 CLI 路径（必填）	—
`WECHAT_PROJECT_PATH`	默认项目根目录（必填）	—
`WECHAT_CLI_TIMEOUT`	CLI 超时秒数	`30`
`WECHAT_CDP_PORT`	CDP 调试端口默认值。9222 常被 Chrome 占用时设成 `9333`；`open` 成功后同会话其它工具自动沿用	`9222`
`WECHAT_AUTOMATOR_READY_TIMEOUT`	`start` 等待 automator 首次应答的秒数，大项目冷启动可加大	`45`
`NODE_PATH`	Node.js 可执行文件	`node`

❓ 常见问题

症状	处理
一直报 `CLI_TIMEOUT`	服务端口没开，见 Step 2；`wechat_ide(action='status')` 的 `service_port_enabled` 可自查
CDP 采集失败 / 采到的全是别的网页	`status` 的 `cdp_port_occupant.kind` 为 `foreign` 即端口被别的浏览器占着：`open(cdp_port=9333)` 或设 `WECHAT_CDP_PORT`，之后其它工具不传端口自动沿用。0.9.19 起 `open` 会直接报错，不再把别人的页面报错当启动错误
automator 9420 连不上 / `start` 返回 `verified=false`	0.9.19 起动作失联会自动 `start` 一次并重试；`start` 自带最多 45 秒就绪等待（`ready_timeout` 可调）。仍失败看 `status` 的 `project_window_open`，窗口被关就再 `start`，不要先 `open` 重启 IDE
Windows 中文乱码或 `UnicodeDecodeError`	`env` 加 `"PYTHONIOENCODING": "utf-8"`
装了新版仍跑旧版	`pip uninstall wechat-devtools-mcp`；`uvx` 方式跑 `uvx --refresh wechat-devtools-mcp --version`；最后以 `status` 的 `mcp_version` 为准
IDE 2.x 下工具行为异常	注册名与官方 `wechat-devtools` 撞车，改用 `wechat-devtools-mcp`

📋 版本历史

版本	日期	摘要
0.9.20	2026-10-26	`call_wx` 同步 wx API 自动经 evaluate 直调，不再 10 秒超时；README / MCP_DOC / SKILL 逐字段核对修正；Node.js ≥ 18 门槛明示
0.9.19	2026-10-26	automator `start` 按截止时间等就绪，根治「握手未完成」误报；CDP 端口占用检测与会话粘性（`WECHAT_CDP_PORT`）；automator 失联自动恢复；`status` 新增项目窗口 / skill 版本诊断
0.9.18	2026-09-04	Windows 2.x 真机闭环：状态目录 `User Data` 层、就绪判据、`quit` 等退出、噪音过滤；新增真机冒烟脚本
0.9.17	2026-09-03	适配开发者工具 2.x Stable；evaluate 新增 `fn_source`；`open` 提速约 4 倍；Windows 1.x/2.x 双轨判定
0.9.16	2026-08-27	长页面截图全面修复；源码开源
0.9.15	2026-08-20	适配开发者工具 2.x（Electron）；修复 CDP 采集自 0.9.0 起恒为 0 条
0.9.14	2026-08-20	`wechat_file` 路径口径统一；`cdp_port` 透传修复
0.9.13	2026-08-18	`--version` 早退；文档核对修复

完整逐版本说明见 CHANGELOG.md。

参考

微信开发者工具 CLI · 小程序自动化 SDK
许可证：MIT

Wechat DevTools MCP

What it does

Installation

Python (uv) installieren

Bei Wechat DevTools MCP registrieren und Schlüssel erstellen

Einstellungsdatei der Claude-Desktop-App öffnen

Diese Einstellungen einfügen und speichern

Claude beenden und neu öffnen

Ausprobieren

Das kannst du stattdessen tun

Python (uv) installieren

Bei Wechat DevTools MCP registrieren und Schlüssel erstellen

Terminal öffnen

Diesen Befehl einfügen und Enter drücken

/mcp in Claude Code eingeben

Ausprobieren

Python (uv) installieren

Bei Wechat DevTools MCP registrieren und Schlüssel erstellen

Mit diesem Button Cursor öffnen

Schlüssel eintragen

KI-Chat in Cursor im Agent-Modus öffnen

Ausprobieren

Python (uv) installieren

Bei Wechat DevTools MCP registrieren und Schlüssel erstellen

Mit diesem Button VS Code öffnen

Schlüssel eintragen

KI-Chat in VS Code im Agent-Modus öffnen

Ausprobieren

Auf deinem Computer installiert

Werte, die du selbst einträgst

Auf einen Blick

Welche Apps ihn nutzen können

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Diskussion

Nutzerbewertungen

Im Vergleich mit anderen in Entwicklertoolsi

Häufige Fragen

Andere in derselben Kategorie

REA

GitHub

Serena MCP: the IDE for your agent

README vom Entwickler

微信开发者工具 MCP Server (v0.9.20)

🤝 与官方能力的关系

🚀 快速开始

Step 1 — 安装 MCP Server

Step 2 — 开启开发者工具服务端口

Step 3 — 准备两个绝对路径

Step 4 — 编辑器配置

Step 5 — 安装 Skill（必须）

Step 6 — 自检

🛠️ 工具箱

💡 环境变量

❓ 常见问题

📋 版本历史

参考