Commit 225d6b4
committed
docs: add comprehensive AI technical gotchas guide for MCP builders
Analyze GitHub issues (sorted by comments), PRs, and source code to
document key technical challenges for building browser automation MCPs
with AI agents.
Key findings grounded in actual code:
- Token explosion from automatic snapshots in input tools (src/tools/input.ts)
- Error handling patterns learned from crashes (src/main.ts, src/PageCollector.ts)
- WSL2 Chrome discovery issues (src/browser.ts)
- Dual-format output implementation (src/formatters/SnapshotFormatter.ts)
- Accessibility tree limitations from Puppeteer dependency
Sources: Issues ChromeDevTools#131, ChromeDevTools#363, ChromeDevTools#617, ChromeDevTools#635, ChromeDevTools#689, ChromeDevTools#690, ChromeDevTools#709, ChromeDevTools#713, ChromeDevTools#716, ChromeDevTools#726, ChromeDevTools#752
PRs: ChromeDevTools#618, ChromeDevTools#710, ChromeDevTools#744
Commits: f59b4a2, ca0f560, 3fcca021 parent 0284d18 commit 225d6b4
1 file changed
+472
-0
lines changed
0 commit comments