watertian avatar

Wechat Devtools Mcp

watertian/wechat-devtools-mcp

Wraps the WeChat DevTools CLI into seven aggregated MCP APIs that let AI agents orchestrate the full lifecycle of WeChat Mini Program development, from opening projects and launching previews to running automated UI tests and taking screenshots. Built around a "thin MCP, thick skill" architecture, it requires pairing with the bundled wechat-devtools Skill (installed via npx or manually into .agents/skills/) that provides the SOP workflows, parameter references, and troubleshooting guides AI needs to correctly sequence operations. Works cross-platform on Windows and macOS. You'll need to enable the IDE's service port manually and configure absolute paths to the CLI executable and your project directory. Best for teams automating Mini Program builds and QA loops with Claude or other MCP-aware editors.

GitHub stars
166
tools
7
auth
Required
transport
STDIO
env vars
6
last updated
Nov 9, 2026

Tools

7 tools

Public tool metadata for what this MCP can expose to an agent.

wechat_ideIDE 生命周期与环境诊断

IDE 生命周期与环境诊断

No parameter schema in public metadata yet.

wechat_build构建与发布

构建与发布

No parameter schema in public metadata yet.

wechat_automator自动化交互与运行时查询

自动化交互与运行时查询

No parameter schema in public metadata yet.

wechat_inspector运行时日志采集

运行时日志采集

No parameter schema in public metadata yet.

wechat_screenshot长图拼接截图

长图拼接截图

No parameter schema in public metadata yet.

wechat_navigate跳转并采集 CDP 日志

跳转并采集 CDP 日志

No parameter schema in public metadata yet.

wechat_file项目文件读取

项目文件读取

No parameter schema in public metadata yet.

Sponsors

Configuration

WECHAT_DEVTOOLS_CLI*

微信开发者工具 CLI 路径。Windows: C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat;macOS: /Applications/wechatwebdevtools.app/Contents/MacOS/cli

WECHAT_PROJECT_PATH*

默认小程序项目绝对路径,例如 D:\Projects\MyMiniApp

WECHAT_CLI_TIMEOUTdefault: 30

CLI 命令超时时间(秒)

NODE_PATHdefault: node

Node.js 可执行文件路径

WECHAT_CDP_PORTdefault: 9222

CDP 调试端口默认值;9222 被 Chrome 占用时设为 9333

WECHAT_AUTOMATOR_READY_TIMEOUTdefault: 45

automator start 等待首次应答的秒数

Readme

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

PyPI version MCP Registry License: MIT English

把微信开发者工具封装为 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(49 个原子工具,其中 2 个已废弃;Stable 2.02.2609250 内置 skill 0.3.11)。两者互补,不是替代:


View the full README on GitHub

Details

Repository
github.com/watertian/wechat-devtools-mcp
Category
Automation & Workflows
Package
wechat-devtools-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Automation & Workflows MCP servers

View all
1sathergate avatarDarkroomsathergate/sathergate-toolkitImage processing pipeline for Next.js. Responsive optimization with Sharp.0stars
2sh3ll3x3c avatarNative DevToolssh3ll3x3c/native-devtools-mcpMCP server for desktop, browser (CDP), and Android automation. Screenshot, OCR, click, type.113stars
3ndesv21 avatarSocialclawndesv21/socialclawConnect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.106stars
4jeomon avatarmacOS-MCPjeomon/macos-mcpMCP server for macOS desktop automation via the Accessibility API.69stars
5kastalien-research avatarThoughtboxkastalien-research/thoughtboxExtended reasoning with structured processes, persistence, and workflow guidance60stars
6etairl avatarParallel Browser MCPetairl/parallel-browser-mcpMCP server for parallel browser automation across multiple providers.51stars