WeChat DevTools Bridge

WeChat DevTools Bridge

An open-source Codex plugin that connects WeChat Mini Program tooling to MCP and automation workflows.

What it does

• Provides a local Codex plugin manifest
• Ships an MCP configuration for Windows
• Adds helper scripts to locate WeChat DevTools and check prerequisites
• Provides executable wrappers for open, preview, upload, and automator smoke tests

Current approach

This plugin uses official WeChat-adjacent tooling for the executable path and keeps MCP pluggable.

That gives us a practical bridge for:

• checking WeChat DevTools availability
• connecting Codex to local Mini Program tooling
• opening, previewing, and uploading projects
• validating automator connectivity

Prerequisites

• Windows PowerShell
• Node.js 16+
• nvm for Windows is supported
• WeChat DevTools installed
• WeChat DevTools service port enabled

Files

• .codex-plugin/plugin.json: Codex plugin manifest
• .mcp.json: MCP server wiring
• scripts/check-prereqs.ps1: local environment check
• scripts/find-wechat-devtools.ps1: locate a likely DevTools CLI path
• scripts/invoke-weapp-cli.ps1: shared wrapper around weapp-ide-cli
• scripts/open-project.ps1: open the current project in WeChat DevTools
• scripts/preview-project.ps1: run a preview flow
• scripts/upload-project.ps1: run an upload flow
• scripts/start-weapp-devtools-mcp.ps1: launches a configurable MCP package
• scripts/automator-smoke.cjs: validates miniprogram-automator connectivity
• package.json: npm dependencies and convenience scripts

Quick start

1. Open WeChat DevTools and enable the service port in security settings.
2. Run:

./scripts/check-prereqs.ps1

1. If needed, set the CLI path explicitly:

$env:WECHAT_DEVTOOLS_CLI = "C:\\Path\\To\\WeChatDevTools\\cli.bat"

1. Start the MCP bridge manually:

./scripts/start-weapp-devtools-mcp.ps1

1. Open the current mini program project:

./scripts/open-project.ps1

1. Run an automator smoke test after DevTools is exposing the websocket endpoint:

$env:WECHAT_WS_ENDPOINT = "ws://127.0.0.1:9420"
npm run automator:smoke

npm scripts

npm install
npm run check
npm run devtools:open
npm run devtools:preview
npm run automator:smoke

devtools:upload requires additional arguments, for example:

./scripts/upload-project.ps1 -Version 0.1.0 -Desc "Initial upload"

Environment variables

• WECHAT_DEVTOOLS_CLI: explicit path to the DevTools CLI
• WECHAT_PROJECT_PATH: mini program project root
• WECHAT_WS_ENDPOINT: automator websocket endpoint, default ws://127.0.0.1:9420
• WECHAT_MCP_NPX_PACKAGE: optional community MCP package name used by start-weapp-devtools-mcp.ps1
• WECHAT_NODE_EXE: optional explicit node.exe override
• WECHAT_NPX_CMD: optional explicit npx.cmd override

nvm for Windows

If you use nvm for Windows, the scripts now try:

1. WECHAT_NODE_EXE / WECHAT_NPX_CMD
2. the current shell node / npx
3. NVM_SYMLINK\\node.exe and NVM_SYMLINK\\npx.cmd
4. NVM_HOME\\<current-version>\\node.exe and npx.cmd when NVM_CURRENT is set
5. C:\\Program Files\\nodejs\\node.exe and npx.cmd

If your environment still does not resolve Node correctly, run nvm use <version> first or set the explicit overrides above.

MCP config

The bundled .mcp.json uses:

{
  "mcpServers": {
    "wechat-devtools-bridge": {
      "command": "powershell.exe",
      "args": [
        "-NoProfile",
        "-ExecutionPolicy",
        "Bypass",
        "-File",
        "./scripts/start-weapp-devtools-mcp.ps1"
      ]
    }
  }
}

Recommended toolchain

• weapp-ide-cli: open / preview / upload wrappers around the WeChat DevTools CLI
• miniprogram-automator: websocket-based DevTools automation checks
• a community WeChat DevTools MCP package of your choice, passed via WECHAT_MCP_NPX_PACKAGE

Upstream references

• miniprogram-automator: https://www.npmjs.com/package/miniprogram-automator
• weapp-ide-cli: https://www.npmjs.com/package/weapp-ide-cli
• community MCP example: https://glama.ai/mcp/servers/%40yfmeii/weapp-dev-mcp

Notes

• The helper scripts are intentionally conservative and Windows-first.
• The repository keeps the MCP backend configurable because community MCP packages evolve quickly.
• If you want a pure Node launch path later, we can add one.