newbpydev/mcp-diagnostics-extension
View on GitHub ↗VS Code extension that exposes diagnostic problems via Model Context Protocol (MCP) for AI agents and tools
22 ★4 forksTypeScriptUpdated 10mo ago
What you need to know
Production-oriented VS Code extension that exposes the editor's Problems panel (errors, warnings, hints) in real time over MCP, with a standalone Node MCP server, auto-registration into Cursor/Windsurf/Claude Desktop, and one-click 'Configure Server' setup.
Install
npm install && npm run compile (from source) Install 'MCP Diagnostics Extension' from the VS Code Marketplace
Usage
- •After install the extension auto-activates, registers as an MCP server and shows `$(bug) MCP: XE YW` in the status bar.
- •AI agents query three tools: getProblems, getProblemsForFile and getWorkspaceSummary, plus diagnostics:// resources and problemsChanged notifications.
- •One-click setup: Command Palette → 'MCP Diagnostics: Configure Server' deploys the bundled server to ~/.mcp-diagnostics and injects config (workspace .cursor/mcp.json → user home).
- •For a standalone server add an mcpServers block pointing at node scripts/mcp-server.js with NODE_ENV=production.
Key features
- ✓Real-time diagnostics capture with 300ms (configurable) debounce and structured MCP notifications.
- ✓One-click cross-environment auto-registration (VS Code, Cursor, Windsurf, Claude Desktop) with atomic writes, backups and rollback.
- ✓Cached multi-source fallbacks: VS Code export primary, then direct TypeScript compiler and ESLint analysis.
- ✓Configurable port, debounce, logging and max-problems; status webview with per-severity/source breakdown.
- ✓Cross-platform spawn handling for Windows/macOS/Linux.
Best for
Developers using AI assistants in VS Code/Cursor who want agents to see the current Problems panel state in real time.
Caveats
- ⚠Requires VS Code 1.96.0+, Node.js 22.x and TypeScript 5.8.3+.
- ⚠Real-time data comes from the live VS Code Problems panel; standalone mode relies on cached/fallback sources.
- ⚠MIT licensed.
Platforms: Local · macOS · Windows · LinuxClients: VS Code · Cursor · Windsurf · Claude Desktop · Custom MCP clients
Reviewed 2026-08-18
Topics
ai-agent-toolsai-toolsclean-architecturediagnostic-tooldiagnosticsextension-developmentjestmcpmodel-context-protocolproblems-panelreal-time-monitoringtddtestingtypescriptvscodevscode-extension
- Stars
- 22★
- Forks
- 4
- Language
- TypeScript
- License
- MIT
- Created
- 2025-06-06
- Last push
- 2025-10-27