pip install uv   # Install uv if not present
uv tool install wechat-devtools-mcp --force  # Install wechat-devtools-mcp via uv

{
  "mcpServers": {
    "wechat-devtools": {
      "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"
      }
    }
  }
}

wechat_ide(action='status')                         # Diagnose environment
wechat_ide(action='is_login')                       # Check login status
  ↳ Not logged in: wechat_ide(action='login', qr_format='terminal')
wechat_ide(action='open', cdp_enabled=True)         # Launch IDE + CDP 9222 + automatic health check
  ↳ Returns success=false + startup_errors → Fatal error during mini program startup, must fix before proceeding
  ↳ Returns success=true → Startup normal, proceed to next steps
  ↳ Transient errors may occur during IDE cold start (simulator not found / subPackages of undefined), which is normal, ignore and continue to execute compile to refresh
wechat_automator(action='start')                    # Launch daemon + enable automation port 9420
wechat_file(action='project_info')                  # [Optional] Confirm project structure
wechat_build(action='cache_clean', clean_type='all')     # Clear all cache
wechat_build(action='compile')                            # Compile to establish clean CDP baseline (automatically reconnects automator)
wechat_automator(action='page_data')                # Verify connection availability
  ↳ ⚠ Check if AppID is undefined in the output
  ↳ If undefined → project_path may point to a subdirectory instead of the project root
  ↳ Cloud development project root directory contains project.config.json, miniprogram/ and cloudfunctions/
  ↳ Correct: project_path="D:/MyProject"  Wrong: project_path="D:/MyProject/miniprogram"

wechat_build(action='compile')                      # Compile (automatically reconnects automator)
wechat_automator(action='page_data')                # Verify connection availability

wechat_file(action='list_pages')                           # ⓪ Before first navigation, get list of valid page paths
  ↳ TabBar page paths are usually pages/xxx/index (not pages/xxx/xxx)
wechat_navigate(page_path='pages/xxx/index', wait_ms=3000) # ① Navigate + CDP logs
wechat_automator(action='page_data')                       # ② Check data status
  ↳ ⚠ Must verify that data.path === expected page_path
  ↳ If not matching → Page navigation failed or redirected (see page_data notes)
  ↳ Data exception: set_data(data_json='{"key":"val"}') to hot update and verify
  ↳ Confirm element: element_info(selector='.target')
  ↳ Only when requested by user or visual confirmation is needed: wechat_screenshot()  # Default saves to project screenshots/

wechat_automator(action='page_data')                       # ① Preferred: Directly check page data
  ↳ Key fields are null/empty → Data not loaded or parameter error
  ↳ Data normal → Proceed to step ④ to confirm it's not a data issue
wechat_automator(action='evaluate', expression='wx.cloud.callFunction({name:"xxx",data:{...}})')
                                                            # ② Directly call API to get complete return value
  ↳ Must use this step when encountering [object Object] to get complete JSON
wechat_inspector(action='cdp', duration=5, detail_level='concise')
                                                            # ③ CDP auxiliary reference
  ⚠ CDP error count may include historical cache, rely on page_data instead
wechat_build(action='compile')                              # ④ Capture compilation errors
  ↳ Check wxml_errors field; ⚠ Compilation errors like Chinese quotes "" cannot be captured by the tool

wechat_build(action='cache_clean', clean_type='all')    # Establish clean CDP baseline
wechat_build(action='compile')
  ↳ ⚠ Check if AppID is undefined
wechat_file(action='list_pages')                        # Get page list, confirm valid paths
# Execute sequentially for each page (parallel execution is prohibited):
wechat_navigate(page_path=page, wait_ms=3000)           # Navigate + CDP logs
wechat_automator(action='page_data')                    # Core verification: Key fields are not null/empty
  ↳ ⚠ Must verify that data.path === expected page_path
  ↳ If not matching → Page navigation failed or redirected, mark as exception
  ↳ Fields normal and path matching → ✅ Page passed
  ↳ Fields empty → ⚠ Mark as exception, use evaluate for further diagnosis
  ↳ Only take supplementary screenshots when page_data is abnormal
# Summary: Output report sorted by page_data results

wechat_automator(action='mock_wx', method='requestPayment', result_json='{"errMsg":"requestPayment:ok"}')
wechat_automator(action='mock_wx', method='getUserProfile',  result_json='{"userInfo":{"nickName":"Test User"}}')
wechat_automator(action='mock_wx', method='getLocation',     result_json='{"latitude":23.099,"longitude":113.324}')
wechat_automator(action='tap', selector='.pay-btn')         # Trigger interaction
wechat_automator(action='page_data')                        # Verify data changes

# Intercept requests (logic layer injection)
evaluate(expression='var o=wx.request; wx.request=function(p){console.log(p.url);return o.apply(wx,arguments)}')
# Simulate timeout
mock_wx(method='request', result_json='{"errMsg":"request:fail timeout"}')

mock_wx(method='getSystemInfo', result_json='{"theme":"dark"}')               # Dark mode adaptation
mock_wx(method='getSystemInfo', result_json='{"platform":"mac","windowWidth":1024}')  # iPad/PC adaptation
system_info()                                              # Record windowWidth/Height

wechat_file(action='read_page', page_path='pages/xxx/xxx')  # ① Check onLoad method
  ↳ Confirm query parameter names (such as id / matchId) from options parameter
wechat_navigate(page_path='pages/xxx/xxx?correct_param_name=value', wait_ms=3000)  # ② Navigate
wechat_automator(action='page_data')                          # ③ Verify data
  ↳ Key fields not empty → ✅
  ↳ Most fields are null → Parameter name may be incorrect, go back to ①

wechat_file(action='list_pages')                         # ① Get page list
# Define common fields to verify (such as points, phone_bound, level)
# ② Collect data page by page (execute sequentially, parallel execution is prohibited):
wechat_navigate(page_path=page, wait_ms=3000)
wechat_automator(action='page_data')
  ↳ Verify that data.path === expected page (mark and skip if navigation failed)
  ↳ Extract values of common fields, record to comparison table
# ③ Compare values of fields with the same name across pages
  ↳ Values consistent → ✅ Field passed
  ↳ Values inconsistent → ⚠ Mark as exception, use evaluate to directly call API for comparison
  ↳ When subpage data is abnormal, check if independent data acquisition link is used

# Architecture:
#   Management Backend → Playwright MCP (browser port)
#   Mini Program   → WeChat DevTools MCP (automator port 9420)
#   They use different ports and can run in parallel

# ① Extract data from both ends respectively (can be parallel)
#   Agent A: Operate management backend via Playwright, extract data
#   Agent B: Operate mini program via WeChat MCP, extract page_data
# ② Perform data comparison in main process (serial)

concise → Only errors + warnings (saves tokens, preferred)
  ↓ When summary.errors > 0
full    → Complete logs + source location → wechat_file(action='read_file', file_path=source)

{"success": true,  "data": {...}, "message": "Operation description"}
{"success": false, "error_code": "CLI_TIMEOUT", "message": "...", "hint": "Fix hint"}
{"success": false, "error_code": "UNKNOWN_ERROR", "message": "N errors detected during mini program startup...", "hint": "...", "startup_errors": [...], "cdp_summary": {...}}

wechat_automator(action='start')                    # Only reconnect
wechat_automator(action='page_data')                # Verify

wechat_ide(action='open', cdp_enabled=True)         # Re-open
wechat_automator(action='start')                    # Reconnect
wechat_build(action='compile')                      # Recompile (automatically reconnects automator)
wechat_automator(action='page_data')                # Verify

wechat_ide(action='open', project_path='...', cdp_enabled=true)   # ① Re-open project
wechat_automator(action='start', project_path='...')               # ② Restart automator
wechat_build(action='compile', project_path='...')                 # ③ Recompile
# ④ Retry the failed operation