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