mcp-doctor: a static analysis linter for MCP servers that surfaced real bugs in 12 popular repos
Wide_Imagination_970 · reddit · 2026-09-03
A developer released mcp-doctor, a static analysis linter for MCP servers that detects missing tool descriptions, undocumented params, and missing error handling.
Rather than trusting toy examples, the author ran it against 15 real MCP servers people actually use — SurfSense, Figma-Context-MCP, mcp-chrome, pal-mcp-server (up to 16k stars) — treating every wrong result as a bug in the tool itself. That process uncovered 12 real gaps: some repos registered tools in unfamiliar styles so it reported 0 tools, and FastMCP's excludeargs hides params from the schema entirely, causing 13 tools to be falsely flagged as undocumented. One fix led to a merged PR into ha-mcp.
Install via pip install mcp-server-lint or a GitHub Action; the repo includes a table of every repo tested and what broke.
More from coding & agent
- Hamel Husain: everyone is building this AI agent — don't — hugobowne · 2026-09-03
- Dev accidentally burns $100 in an instant running ultracode AI coding mode — zsakib_ · 2026-09-03
- Hidden-bug eval across 105 issues: Fable 5.1 finds 43, none fixes all — cost per model compared — PawelHuryn · 2026-09-03
- Indie author builds an agent-native distribution layer for his novel with A2A endpoints — patternflow · 2026-09-03
- Bezalel gives AI agents memory, email, money and a cloud desktop behind one MCP URL — Rasmic · 2026-09-03
- jjk-explain turns any concept into a Jujutsu Kaisen-style explainer video with one Claude Code command — teortaxesTex · 2026-09-03