Skip to content

Commit 225d6b4

Browse files
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, 3fcca02
1 parent 0284d18 commit 225d6b4

File tree

1 file changed

+472
-0
lines changed

1 file changed

+472
-0
lines changed

0 commit comments

Comments
 (0)