wechat-devtools-mcp
微信开发者工具 MCP Server (v0.9.15)
微信开发者工具 CLI を MCP (Model Context Protocol) サービスとしてラップし、エディタ内の AI が微信 CLI コマンドを直接呼び出せるようにすることで、ミニプログラムの開発・テスト・デバッグ・自動化の全プロセスをクローズドループで実現します。
[!IMPORTANT] 本プロジェクトは「スリム MCP + リッチ Skill」アーキテクチャを採用しています:MCP Server は 7 つの集約 API を提供し、付属の wechat-devtools Skill が SOP フロー、パラメータ早見表、ベストプラクティスを提供します。両者は必ず組み合わせて使用してください。Skill がない場合、AI は正しいフローでミニプログラムを操作できません。
公式 MCP Registry に公開済みで、クロスプラットフォーム(Windows / macOS)でのワンクリックインストールに対応しています。
🚀 インストールとクイックスタート
Step 1 — MCP Server のインストール
uv の使用を推奨します。Python 依存関係を自動処理し、分離された実行環境を提供します。
pip install uv # 安装 uv(如已安装可跳过)
uv tool install wechat-devtools-mcp --force # 一键安装到全局隔离环境[!WARNING] 以前
pip installで旧バージョンをインストールした場合は、バージョン競合を避けるために先にアンインストールしてください:pip uninstall wechat-devtools-mcp
pip installのパス(例:Python313/Scripts/)がuv tool installのパス(~/.local/bin/)より優先される場合があり、実際には旧バージョンが実行されることがあります。wechat_ide(action='status')が返すmcp_versionフィールドで現在のバージョンを確認できます。
[!WARNING] バージョン互換性:≥0.9.11 は mcp 1.x と 2.x の両バージョンに対応(依存宣言
mcp[cli]>=1.9,<3)。≤0.9.10 は mcp ≥2.0 と互換性がありません(新規インストール時にModuleNotFoundError: mcp.server.fastmcpが発生します。#9 参照)--固定バージョンのユーザーは ≥0.9.11 にアップグレードするか、インストール時に--with "mcp<2"を追加してください。
[!TIP]
実際に実行されているバージョンの確認(≥0.9.13):
wechat-devtools-mcp --version # 零依赖打印实际安装版本;uvx 复用已装环境不自拉最新,此命令可直接确认 uv tool list | grep wechat # 离线确认已安装版本ツールのアップグレード:エディタで MCP サービスが実行中の場合は、先にプロセスを終了してからアップグレードしてください:
# Bash / CMD taskkill /F /IM "wechat-devtools-mcp*" 2>/dev/null; uv tool upgrade wechat-devtools-mcp# Windows PowerShell Get-Process | Where-Object { $_.ProcessName -like "*wechat-devtools*" } | Stop-Process -Force uv tool upgrade wechat-devtools-mcpAgent によるワンクリックアップグレード:
taskkill /F /IM "wechat-devtools-mcp*" 2>/dev/null; uv tool upgrade wechat-devtools-mcp && npx -y skills add WaterTian/wechat-devtools-mcp/.agents/skills/wechat-devtools
Step 2 — 开发者工具のサービスポートを有効化
[!WARNING] 手動で有効化する必要があります。有効化しないと AI は一切のコマンドを送信できません。
操作手順:开发者工具 → 设置 → 安全设置 → 服务端口 → 开启
💡
wechat_ide(action='status')でポートが有効かどうかを確認できます——接続失敗が返された場合は、サービスポートがまだ有効化されていません。
Step 3 — 必要なパスの確認
以下の 2 つの絶対パスを事前に取得してください。後でエディタ設定に入力する必要があります:
パス | Windows の例 | macOS の例 |
微信开发者工具 CLI |
|
|
ミニプログラムのプロジェクトルート |
|
|
macOS ユーザー:JSON 設定ではスラッシュ(
/)のエスケープは不要です。Windows ユーザーは\を\\と記述してください。
Step 4 — エディタ設定
claude_desktop_config.json または mcp_config.json(Antigravity)を編集:
{
"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"
}
}
}
}~/.kiro/settings/mcp.json を編集:
{
"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",
"PYTHONIOENCODING": "utf-8"
},
"autoApprove": [
"wechat_ide", "wechat_build", "wechat_automator", "wechat_inspector",
"wechat_screenshot", "wechat_navigate", "wechat_file"
]
}
}
}~/.codex/config.toml(グローバル)または .codex/config.toml(プロジェクトレベル)を編集:
[mcp_servers.wechat-devtools]
command = "uvx"
args = ["wechat-devtools-mcp"]
[mcp_servers.wechat-devtools.env]
WECHAT_DEVTOOLS_CLI = "C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat"
WECHAT_PROJECT_PATH = "D:\\Your\\Project\\Path"CLI からすばやく追加することもできます:
codex mcp add wechat-devtools \
--env WECHAT_DEVTOOLS_CLI="C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat" \
--env WECHAT_PROJECT_PATH="D:\\Your\\Project\\Path" \
-- uvx wechat-devtools-mcpMCP コンソールで新しい Server を追加:
Name:
wechat-devtoolsType:
commandCommand:
uvx wechat-devtools-mcpEnvironment Variables: 上記と同様に
WECHAT_DEVTOOLS_CLIとWECHAT_PROJECT_PATHを追加
Windows ではパス内のバックスラッシュをエスケープ(
\\)する必要があります。
Claude Code でミニプログラムのリポジトリ内で開発する場合、プロジェクトレベルの .mcp.json を作成できます(リポジトリに自動追従し、コラボレーターにも有効です)。
Windows — リポジトリルートの .mcp.json:
{
"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"
}
}
}
}macOS — リポジトリルートの .mcp.json:
{
"mcpServers": {
"wechat-devtools": {
"command": "/opt/homebrew/bin/uvx",
"args": ["wechat-devtools-mcp"],
"env": {
"PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin",
"WECHAT_DEVTOOLS_CLI": "/Applications/wechatwebdevtools.app/Contents/MacOS/cli",
"WECHAT_PROJECT_PATH": "/Users/<you>/WeChatProjects/<project>",
"NODE_PATH": "/opt/homebrew/bin/node"
}
}
}
}macOS の 3 つの重要な違い:
commandは絶対パス/opt/homebrew/bin/uvxを使用する必要があります(Claude Code が子プロセスを spawn する際、PATHに Homebrew が含まれないため)
env.PATHを明示的に注入する必要があります(npxベースの MCP(cloudbase / chrome-devtools など)と同時に設定する場合に特に必要。そうしないとnpxの#!/usr/bin/env nodeが Node を見つけられません)
NODE_PATHは明示的に指定することを推奨します。daemon 起動時の二重の保険となります
複数の MCP(cloudbase / chrome-devtools など)を同時に設定する場合、各 server で同じパターンで
commandの絶対パスとenv.PATHを処理してください。
Trae v1.3.0+ は MCP に対応しています。AI パネル → 右上の設定 → MCP → 追加 → 手動設定で、以下の JSON を貼り付けて保存します。
Windows:
{
"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"
}
}
}
}macOS:
{
"mcpServers": {
"wechat-devtools": {
"command": "/opt/homebrew/bin/uvx",
"args": ["wechat-devtools-mcp"],
"env": {
"PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin",
"WECHAT_DEVTOOLS_CLI": "/Applications/wechatwebdevtools.app/Contents/MacOS/cli",
"WECHAT_PROJECT_PATH": "/Users/<you>/WeChatProjects/<project>",
"NODE_PATH": "/opt/homebrew/bin/node"
}
}
}
}設定ファイルを直接編集することもできます:
Windows:
%APPDATA%\Trae\User\globalStorage\mcp.jsonmacOS:
~/Library/Application Support/Trae/User/globalStorage/mcp.json
[!IMPORTANT] チャットボックスでは必ず 「Builder with MCP」 エージェントを選択してください。通常のエージェントは MCP ツールを呼び出しません。wechat-devtools Skill(Step 5)も併せてインストールし、AI が SOP 順に呼び出すことを推奨します。
Step 5 — Skill のインストール(必須)
[!IMPORTANT] 本 MCP は wechat-devtools Skill と組み合わせて使用する必要があります。 Skill には、AI がミニプログラムを操作するために必要なすべての SOP フロー、パラメータ早見表、トラブルシューティングガイドが含まれています。Skill がインストールされていない場合、AI はベア API のみを呼び出せ、標準化されたテスト・デバッグフローを自動実行できません。
方法 1:npx skills add(Claude Code ユーザー)
npx -y skills add WaterTian/wechat-devtools-mcp/.agents/skills/wechat-devtools~/.claude/skills/ に取得され、Claude Code が自動的に読み込みます。
方法 2:.agents/skills/ に手動配置(Trae など .agents/skills/ から読み込むクライアント)
ミニプログラムのプロジェクトルートで実行:
git clone --depth 1 https://github.com/WaterTian/wechat-devtools-mcp.git .wdm-tmp
mkdir -p .agents/skills
cp -r .wdm-tmp/.agents/skills/wechat-devtools .agents/skills/
rm -rf .wdm-tmp完了後のディレクトリ構造:
your-project/
└── .agents/skills/
└── wechat-devtools/
├── SKILL.md # 主指令文件(SOP + 能力映射 + 红线规则)
└── references/
└── tool_reference.md # 7 个聚合 API 完整参数参考[!TIP] Trae ユーザー:設定 → 技能与命令 → .agents 技能目录を有効化 スイッチがオンになっていることを確認してください(デフォルトでオン)。保存後に更新すると、「技能 → 项目」タブに
wechat-devtoolsが表示されます。
Related MCP server: harmony-mcp
🛠️ ツールボックス概要
MCP Server は 7 つの集約ツールを提供し、ミニプログラムの全ライフサイクルをカバーします:
ツール | 機能 | 対応 action |
| IDE ライフサイクル管理 |
|
| ビルドと公開 |
|
| 自動化インタラクション |
|
| ランタイムログ収集 |
|
| 画面スクリーンショット(長尺画像結合) | — |
| ページ遷移と CDP ログ収集 | — |
| プロジェクトファイル読み取り |
|
クラウド関数とクラウドデータベースの管理には CloudBase MCP(
manageFunctions/readNoSqlDatabaseContentなど)を使用してください。機能がより完全で、IDE 依存がありません。wechat_cloudは v0.9.5 以降無効化されています。
🧠 Skill の内容詳細
Skill により、AI は自然言語の指示を受け取ると、標準化された操作フローを自動的にマッチングして実行します:
ユーザーの発言 | AI が実行するフロー |
"すべてのページにエラーがないか確認して" | SOP D — 全ページ巡回点検 |
"ログインボタンをクリックして、スクリーンショットで確認して" | SOP B — UI デバッグ |
"ページが白画面になった、調査して" | SOP C — 異常調査 |
"支払い API を Mock して、支払いフローをテストして" | SOP E — Mock 統合テスト |
"詳細ページをテストして、パラメータ名は?" | SOP G — サブページテスト |
"各ページのスコアが一致するか比較して" | SOP I — クロスページデータ検証 |
Skill に含まれるもの
9 つの SOP フロー — 初期化、UI デバッグ、異常調査、全ページ巡回点検、Mock 統合テスト、ネットワークデバッグと UI 適応、サブページテスト、クロスページデータ検証、並行データ比較
能力マッピング辞書 — 7 つの集約ツール × 全 action のクイックインデックス
CDP 段階的調査戦略 — concise → full の 2 段階で、Token 消費を制御
完全なパラメータリファレンス — 各 action の必須/任意パラメータ、戻り値の例、よく使うテンプレート
トラブルシューティングマニュアル — 一般的なエラーコードと修正方法
インストール方法は Step 5 — Skill のインストール を参照
💡 環境変数
変数名 | 説明 | デフォルト値 | 必須 |
| 微信开发者工具 CLI パス | — | はい |
| デフォルトのミニプログラムプロジェクト絶対パス | — | はい |
| CLI コマンドのタイムアウト時間(秒) |
| いいえ |
| Node.js 実行ファイルのパス |
| いいえ |
❓ よくある質問
最も一般的な原因:微信开发者工具の「服务端口」が有効化されていません。
设置 → 安全 → 服务端口 に移動してオンにしてください。オンにした後、IDE の再起動は不要で、AI はすぐに接続を回復します。
開発者ツールを手動で開いた場合、デバッグポートをリッスンしていない可能性があります。開発者ツールを閉じて、AI に wechat_ide(action='open', cdp_enabled=True) を実行させ、デバッグモードで起動してください。
エディタ内の MCP サービスがまだ実行中です。Step 1 の下にあるアップグレードのヒントを参照してください——先にプロセスを終了してからアップグレードする必要があります。
pip install でインストールされた旧バージョンの優先度が高い可能性があります。pip uninstall wechat-devtools-mcp を実行して旧バージョンを削除し、wechat_ide(action='status') で mcp_version フィールドが最新バージョンであることを確認してください。
エディタ設定の env で WECHAT_DEVTOOLS_CLI に絶対パスが入力されていることを確認してください:
Windows: 二重バックスラッシュを使用(例:
C:\\...\\cli.bat)macOS: 標準パス
/Applications/wechatwebdevtools.app/Contents/MacOS/cli、スラッシュのエスケープは不要
GUI クライアント(Claude Desktop など)が MCP を起動する際、PATH に /opt/homebrew/bin が含まれない場合があります。MCP v0.9.6 以降は Homebrew の標準パスを自動的に試行します。それでも失敗する場合は、env で明示的に設定してください:
"NODE_PATH": "/opt/homebrew/bin/node"📋 バージョン履歴
版本 | 説明 |
0.9.15 | 開発者ツール 2.x(Electron)への対応 + CDP 収集の長期的な不具合の修正:開発者ツール 2.x は Electron に変更(1.06.x Stable は依然として NW.js、二重トラックで互換性を維持し置き換えない)。macOS の起動パスは |
0.9.14 | ファイル読み取りパスの修正 + パラメータ無効の修正: |
0.9.13 |
|
0.9.12 | ハンドシェイク応答パッケージのバージョン + 依存関係の上限:mcp 2.x では |
0.9.11 | mcp 2.0.0 への対応:公式 MCP Python SDK 2.0(2026-07-28 リリース)が |
0.9.10 | page_path のサイレント失敗を修正:screenshot.js でナビゲーション後にページパスが一致するか検証し、 |
0.9.9 | スクリーンショットによるミニプログラムの再起動を修正:screenshot.js の非 TabBar ページへのナビゲーション方法を |
0.9.8 | automator 接続の安定性を修正:daemon.js の |
0.9.7 | daemon の孤児プロセス残留を修正:daemon.js に親プロセスの watchdog を追加し、5 秒ごとに |
0.9.6 | macOS 対応: |
0.9.5 | compile ヘルスチェックが永久に失敗する潜在バグを修正(ui_debug.js に |
0.9.4 | switchTab ジャンプが機能しない問題を修正( |
バージョン | 説明 |
0.9.3 | status に |
0.9.2 | compile 後の navigate タイムアウトを修正:daemon 接続ヘルスチェックに 3 秒のタイムアウト保護を追加。compile 後に古いキャッシュ接続を自動的に無効化してから再接続。navigate currentPage のポーリング毎に 2 秒の独立タイムアウトを追加。HEALTH_CHECK_TIMEOUT と CONNECTION_ERROR のエラーコードを区別 |
0.9.1 | cdp_enabled=true 時の AttributeError クラッシュを修正。WXML ランタイムエラー収集を新規追加(compile 後に CDP が template not found などの警告を自動キャプチャ) |
0.9.0 | 永続化 Node daemon アーキテクチャ:単一の daemon プロセスが常駐し、NDJSON プロトコルで通信、WS 接続はポート単位で再利用。8 つの独立 bundle を単一の daemon.bundle.js に統合。ツール呼び出しの遅延が 500ms+ から ~3ms に短縮。compile 後に daemon が自動的に接続を再構築し、切断ゼロを実現 |
0.8.0 | compile 後に automator へ自動再接続。navigate が TabBar ページを自動認識し switchTab を使用。screenshot に full_page/scroll_top/page_path パラメータとビューポートスクリーンショットモードを追加。page_data に expected_path ポーリングを追加し古いデータを防止。長尺画像の動的ステップ結合でコンテンツ欠落を修正。node_bridge の接続切断リトライを統一し、500ms の呼び出し間隔を設定。start のポート検証を 20 回に増加 |
0.7.0 | navigate の変数スコープを修正(currentPageTimeout)。evaluate が宣言文(const/let/var fallback)をサポート。call_method が現在のページパスを返却。automator start のポートポーリング検証を盲目的待機から変更。SKILL.md に効率原則、復旧レベル、ページ遷移方法、6 件の障害項目を追加 |
0.6.0 | navigate が query パラメータをサポート(reLaunch タイムアウト fallback)。CDP 起動ノイズフィルタリング(console.assert/__route__/ide:// のノイズ低減 + WXML エラー保護)。compile の戻り値を 3 分類し、automator 無効化のヒントを追加。navigate currentPage のポーリング再試行。タイムアウトを設定可能に |
0.5.1 |
|
0.5.0 | Skill SOP を全面的に最適化:SOP I/J を新規追加。AppID チェックと path 検証を追加。CDP ノイズフィルタリング。スクリーンショット結合の曖昧マッチングを修正 |
0.4.1 | スクリーンショット長尺ページ結合を書き直し:固定領域検出、DPR 適応、動的重複計算 |
0.4.0 | CDP ログ強化、クラウド関数デプロイの自動検証、navigate スマート診断、SOP G/H を新規追加 |
0.3.0 | 大規模リファクタリング:44 個のツールを 8 個の API に集約。CDP ログ v2。SKILL.md ナレッジベースを新規追加 |
0.2.6 | README に OpenAI Codex 設定説明を追加 |
0.2.5 | Kiro エディタの設定説明を新規追加 |
0.2.4 | スクリーンショットスクロール結合を修正: |
0.2.3 | 公開パッケージを最適化: |
0.2.2 | Node.js スクリプトを bundle-only モードに変更 |
0.2.1 | バージョン更新とドキュメント整備 |
0.2.0 | navigate を CDP 高解像度ログ収集に変更 |
0.1.9 | UTF-8 エンコーディングの文字化けを修正 |
0.1.8 | Windows の中国語パスにおける UnicodeDecodeError を修正 |
0.1.7 | core/full ツールセットのプリセットを新規追加。MCP_DOC.md を新規追加 |
0.1.6 |
|
0.1.5 | Windows の stdio ブロッキング問題を修正 |
0.1.4 | CDP ログ、スクリーンショット、自動化などの機能を追加 |
0.1.3 | 初期バージョン |
参考ドキュメント
ライセンス
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables AI assistants to automate WeChat Developer Tools for mini programs, allowing navigation, inspection, and manipulation of pages and components through the miniprogram-automator API.2767174MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that enables AI assistants to interact with WeChat Mini Programs, allowing developers to publish versions, analyze package size, diagnose compilation errors, and manage projects via natural language.783MIT
- AlicenseAqualityAmaintenanceMCP server for WeChat Mini Program debugging and automation, enabling agents to perform UI operations, screenshots, and regression testing through natural language commands.4417914MIT
- AlicenseNot gradedqualityDmaintenanceConnects WeChat Mini Program tooling to MCP and automation workflows. Provides scripts for opening, previewing, and uploading projects, as well as automator smoke tests.1MIT
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server for Hailuo (MiniMax) AI video generation
MCP connector that lets ChatGPT list, search, and run your Apple Shortcuts via a local Mac agent
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/WaterTian/wechat-devtools-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server