The MCP Diagnostics Extension is a production-ready VS Code extension that exposes diagnostic problems (errors, warnings, and related issues) in real-time through the Model Context Protocol (MCP). This enables AI agents and MCP-enabled tools to consume up-to-date diagnostic data from your workspace, allowing automated analysis, fixes, and insights to be applied as you code. The extension uses an event-driven architecture to stream diagnostics, supports cross-platform operation, and includes live synchronization of issues as you edit files. It is designed to integrate with MCP clients that rely on the MCP SDK, enabling seamless AI-assisted debugging and linting workflows.

To use its MCP capabilities, install the MCP Diagnostics Extension and configure the MCP server connection as described in the installation guide. The extension provides automatic MCP server registration, a robust export mechanism for diagnostic data, and a set of commands to manage server setup across different environments. Once running, MCP clients can subscribe to diagnostic events, receive real-time updates, and leverage those insights to propose fixes, track problem trends, or summarize workspace health for teams and AI agents.

Prerequisites:

• Node.js 22.x installed on your system
• NPM (comes with Node.js) available on your PATH
• Access to run or install the MCP Diagnostics Extension package

Installation steps:

1. Verify Node.js installation node -v npm -v

2. Install the MCP Diagnostics Extension via NPX (recommended simple start) npx -y newbpydev.mcp-diagnostics-extension

   This installs and runs the MCP server packaged with the extension

3. Alternatively, install from npm registry or marketplace per your environment npm install -g newbpydev.mcp-diagnostics-extension

   Run or register the MCP server as needed by your MCP client setup

4. Configure MCP client connections if you are integrating with external AI agents or MCP tools. Refer to the extension's docs for details on server registration, endpoint configuration, and authentication if applicable.

Notes:

• If you encounter permission issues with NPX, try running with elevated privileges or adjust your npm permissions.
• Ensure your environment supports the extension’s cross-platform spawn behavior (Windows, macOS, Linux).

Tips and considerations:

• The MCP server name in configuration should match the registered server name (here, mcp-diagnostics-extension).
• Environment variables can be used to store configuration secrets or placeholders for the MCP client. Add variables under the env section of the mcp_config as needed.
• This extension emphasizes real-time diagnostic streaming; ensure your MCP client subscribes to the appropriate diagnostic events to leverage AI-assisted analysis.
• If you update to newer versions, verify compatibility with your MCP SDK version (as indicated by the MCP SDK badge in the README).