Wechat DevTools MCP

Name: Wechat DevTools MCP
Author: WaterTian

제작자: WaterTian버전 0.9.20i★ –i내 컴퓨터에서 실행

레지스트리 이름io.github.WaterTian/wechat-devtools-mcp

설치

개요

제작자가 쓴 설명(영어 원문)

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

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

사용자 의견i아직 리뷰가 없어요리뷰는 다음 단계에서 계정 기능과 함께 열려요
우리의 기본 점검i1개 중 1개 통과공개된 정보로 점검했으며, 코드는 아직 스캔하지 않았어요
사용 정도i아직 측정 안 함★ –

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

연결 방식: 내 컴퓨터에서 실행
전송 방식: stdio
카테고리: 기타
입력해야 할 값: WECHAT_DEVTOOLS_CLI, WECHAT_PROJECT_PATH

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

기본 점검: 1개 중 1개 통과
내 컴퓨터에서 내 사용자 계정의 권한(파일, 네트워크, 앱)으로 실행돼요.
직접 입력할 값: WECHAT_DEVTOOLS_CLI, WECHAT_PROJECT_PATH, WECHAT_CLI_TIMEOUT, NODE_PATH, WECHAT_CDP_PORT, WECHAT_AUTOMATOR_READY_TIMEOUT

필요한 것

PyPIPython의 uv 설치(uvx 명령어용)

어떤 앱을 쓰세요?

ClaudeClaude CodeCursorVS CodeChatGPT

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

Claude Desktop → Settings → Developer → Edit Config를 열고 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"
      }
    }
  }
}

터미널에서 이 명령어를 실행하세요

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

실행하기 전에 빈 값을 채워 주세요.

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.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에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/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"
      }
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

WECHAT_DEVTOOLS_CLI 필수 env
微信开发者工具 CLI 路径。Windows: C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat；macOS: /Applications/wechatwebdevtools.app/Contents/MacOS/cli
WECHAT_PROJECT_PATH 필수 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 等待首次应答的秒数

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 7일 점검

✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 WaterTian 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
… 아직 점검 안 함
계속 관리되고 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
… 아직 점검 안 함
라이선스 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
– 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
– 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
… 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

기타 카테고리의 다른 서버와 비교i

이 카테고리의 다른 서버 32589개 중 0%보다 스타가 많아요
이 카테고리의 다른 서버 32589개 중 75%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 32589개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Wechat DevTools MCP, 안전한가요?

해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: WECHAT_DEVTOOLS_CLI, WECHAT_PROJECT_PATH

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(0.9.20)은 11일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Python (uv)도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Spec Driven Development, Remote Desktop Commander, Detailing Manager

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Spec Driven Development

제작자: formulahendry

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

내 컴퓨터에서 실행★ 440MIT14개월 전 업데이트

설치

Remote Desktop Commander

제작자: desktop-commander

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

클라우드에서 실행★ 211어제 업데이트

설치

Detailing Manager

제작자: RadoslavMoshev

Connect your auto detailing studio's tasks, cars, clients and revenue to Claude or ChatGPT.

내 컴퓨터에서 실행오늘 업데이트

설치

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

微信开发者工具 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

개요

PopNx MCP의 세 기둥

할 수 있는 일

설치

설치하기 전에

직접 입력할 값

할 수 있는 일

기본 점검i

제작자와 저장소 일치

계속 관리되고 있음

라이선스 있음

엔드포인트 응답

OAuth로 로그인

도구 설명에 숨겨진 지시 없음

기타 카테고리의 다른 서버와 비교i

자주 묻는 질문

대안

Spec Driven Development

Remote Desktop Commander

Detailing Manager

제작자의 README

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

🤝 与官方能力的关系

🚀 快速开始

Step 1 — 安装 MCP Server

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

Step 3 — 准备两个绝对路径

Step 4 — 编辑器配置

Step 5 — 安装 Skill（必须）

Step 6 — 自检

🛠️ 工具箱

💡 环境变量

❓ 常见问题

📋 版本历史

参考