WPF DevTools MCP Server
需要英文文件？請回到 English documentation。
WPF DevTools MCP Server 是 Windows-only 的 Model Context Protocol server，用於檢查與操作正在執行的 WPF 應用程式。它提供 visual tree、logical tree、binding、DependencyProperty、routed event、layout、screenshot、MVVM state 與受控 runtime mutation 的 WPF 原生診斷能力。
安裝
安裝最新 stable release：
irm https://installer.wpf-mcptools.evanlau1798.com | iex
Installer 會解析已審查的 online installer，驗證 release_<version>_win-<arch>.zip 的版本化 package metadata，並安裝封裝後的 executable。一般安裝不需要手動下載 release ZIP。
ARM64 發行檔可作為 preview asset 提供，但目前不保證穩定性，因為尚無可行的 Windows-on-ARM runtime 驗證硬體。
手動驗證安裝是已審查 archive 的獨立路徑。請把 SHA256SUMS.txt、release-assets.json、release-sbom.spdx.json 與 package-sbom.spdx.json 放在 archive 旁邊，然後依照 手動驗證安裝 操作。
此路徑仍需明確 release trust：Signed package 需要 WPFDEVTOOLS_RELEASE_SIGNER_THUMBPRINT，ReleaseChecksumOnly beta package 依賴 SHA256 release metadata。只有在完成 sidecar verification 後，才使用 package-local run.bat。
選擇文件路徑
| 需求 | 起點 |
|---|---|
| 快速安裝與第一次連線 | 5 分鐘快速開始 |
| 從已審查本機 archive 安裝 | 手動驗證安裝 |
| 註冊 MCP client | AI Agent Client |
| 讓 agent 取得 runtime workflow contract | AI Agent 使用指南 |
| 依照穩定任務流程操作 | 常見工作流程 |
| 先釐清專案常用詞 | 詞彙表 |
| 查看 MCP resources、prompts 與 navigation fields | MCP Contracts 與 Navigation |
| 在自己的 app 中 host Inspector | SDK-Hosted Inspector |
| 檢查安全 gate | 安全模型 |
| 部署已審查 package | 部署指南 |
| 理解發行版資產 | 發行版配置 |
| 瀏覽工具 | 工具總覽 |
可以做什麼
- 探索並連線到已審查的 WPF target。
- 先使用
get_ui_summary與get_form_summary取得 scene-level summary。 - 診斷 binding failure、DependencyProperty precedence、template、routed event、layout state 與 focus state。
- 只有在 mutation gate 明確啟用時，才使用 snapshot、diff 與 rollback-oriented workflow。
- 只有在 ViewModel inspection gate 明確啟用時，才檢查 ViewModel state。
範圍與邊界
- Transport：STDIO MCP server。
- Platform：只支援 Windows。
- Target UI stack：只支援 WPF。
- Persistence：runtime mutation 不會寫回 XAML。
- Security：process details、UI text、screenshot、ViewModel value 或 mutation operation 回傳前都會先通過 policy gate。
- Transport hardening：injection-based sessions 預設使用持久化的本機 HMAC secret 與 named-pipe TLS。