Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Bewertungen und Benutzerkonten folgen in einem späteren Schritt.
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Wechat DevTools MCP

von WaterTianVersion 0.9.20i★ –iLäuft auf deinem Computer
Name in der Registryio.github.WaterTian/wechat-devtools-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

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

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

  • Verbindung: Läuft auf deinem Computer
  • Transport: stdio
  • Kategorie: Sonstiges
  • Das musst du eintragen: WECHAT_DEVTOOLS_CLI, WECHAT_PROJECT_PATH

Installation

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

Bevor du installierst

  • Basischecks: 1 von 1 bestanden
  • Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
  • Das trägst du selbst ein: WECHAT_DEVTOOLS_CLI, WECHAT_PROJECT_PATH, WECHAT_CLI_TIMEOUT, NODE_PATH, WECHAT_CDP_PORT, WECHAT_AUTOMATOR_READY_TIMEOUT

Du brauchst

  • PyPIuv für Python installiert (für den Befehl uvx)

Welche App nutzt du?

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "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ühre das in deinem Terminal aus

claude mcp add 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

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

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

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

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

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

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.

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 7. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto WaterTian bestätigt, dem das Repo gehört

  • … Noch nicht geprüft

    Wird noch gepflegt

    Dieses Repo haben wir noch nicht von GitHub gelesen

  • … Noch nicht geprüft

    Hat eine Lizenz

    Dieses Repo haben wir noch nicht von GitHub gelesen

  • – 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

Im Vergleich mit anderen in Sonstigesi

  • Mehr Sterne als 0 % der anderen 32568 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 75 % der anderen 32568 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 100 % der anderen 32568 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 1 von 1 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 – geändert, und die neueste Version (0.9.20) kam vor 11 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: Spec Driven Development, Remote Desktop Commander, FlyDocs

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

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

Spec Driven Development

von formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Läuft auf deinem Computer★ 440MITAktualisiert vor 14 Monaten
Installieren

Remote Desktop Commander

von desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Läuft in der Cloud★ 211Aktualisiert gestern
Installieren

FlyDocs

von flydocs.ai

Spec-driven development workflow: your agent works issues, sessions and the status lifecycle.

Läuft auf deinem ComputerAktualisiert heute
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 — 准备两个绝对路径
路径WindowsmacOS
开发者工具 CLIC:\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 / Antigravityclaude_desktop_config.json / mcp_config.json无
Claude Code(项目级)仓库根目录 .mcp.jsonuvx 走终端 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.3AI 面板 → 设置 → MCP → 手动配置;或 %APPDATA%\Trae\User\globalStorage\mcp.json / ~/Library/Application Support/Trae/User/globalStorage/mcp.json聊天须选 Builder with MCP 智能体;macOS 报找不到 uvx 时同上改绝对路径
Cursor / VS CodeMCP 面板新增 serverName wechat-devtools-mcp,Command uvx wechat-devtools-mcp,环境变量同上
OpenAI Codex~/.codex/config.tomlTOML,见下
[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_availabletrue核对 Step 3 的两个路径;安装 Node.js ≥ 18
service_port_enabledtrue见 Step 2
cdp_port_occupant.kindnone 或 ideforeign 表示端口被别的浏览器占着,设 WECHAT_CDP_PORT=9333
skill_version等于 mcp_version重跑 Step 5 更新 skill 副本

🛠️ 工具箱

工具用途action / 关键参数
wechat_ideIDE 生命周期与环境诊断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_TIMEOUTCLI 超时秒数30
WECHAT_CDP_PORTCDP 调试端口默认值。9222 常被 Chrome 占用时设成 9333;open 成功后同会话其它工具自动沿用9222
WECHAT_AUTOMATOR_READY_TIMEOUTstart 等待 automator 首次应答的秒数,大项目冷启动可加大45
NODE_PATHNode.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=false0.9.19 起动作失联会自动 start 一次并重试;start 自带最多 45 秒就绪等待(ready_timeout 可调)。仍失败看 status 的 project_window_open,窗口被关就再 start,不要先 open 重启 IDE
Windows 中文乱码或 UnicodeDecodeErrorenv 加 "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.202026-10-26call_wx 同步 wx API 自动经 evaluate 直调,不再 10 秒超时;README / MCP_DOC / SKILL 逐字段核对修正;Node.js ≥ 18 门槛明示
0.9.192026-10-26automator start 按截止时间等就绪,根治「握手未完成」误报;CDP 端口占用检测与会话粘性(WECHAT_CDP_PORT);automator 失联自动恢复;status 新增项目窗口 / skill 版本诊断
0.9.182026-09-04Windows 2.x 真机闭环:状态目录 User Data 层、就绪判据、quit 等退出、噪音过滤;新增真机冒烟脚本
0.9.172026-09-03适配开发者工具 2.x Stable;evaluate 新增 fn_source;open 提速约 4 倍;Windows 1.x/2.x 双轨判定
0.9.162026-08-27长页面截图全面修复;源码开源
0.9.152026-08-20适配开发者工具 2.x(Electron);修复 CDP 采集自 0.9.0 起恒为 0 条
0.9.142026-08-20wechat_file 路径口径统一;cdp_port 透传修复
0.9.132026-08-18--version 早退;文档核对修复

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


参考

PopNx fragen