drio
Open app

Debug MCP Server in VSCode

Source

Create sample MCP server and able to debug in VSCode

Catalog onlyCatalog onlySTDIO

Overview

MCP Sample VSC Debug is a project that allows users to create and debug a sample Model Context Protocol (MCP) server using Visual Studio Code (VSCode).

To use this project, clone the repository and navigate to your preferred programming language (Python or TypeScript). Follow the instructions in the respective README files to set up and debug the server.

  • Sample MCP server implementation in Python and TypeScript. - Integration with MCP Inspector for easy testing in the browser. - Step-by-step guidance through README files for both languages.
  1. Developing and debugging MCP servers in a local environment.
  2. Learning how to implement MCP using Python or TypeScript.
  3. Testing MCP tools using the MCP Inspector.

Add to your AI client

Use these steps to connect Debug MCP Server in VSCode in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-sample-vsc-debug-swatdong": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-sample-vsc-debug-swatdong"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-sample-vsc-debug-swatdong": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-sample-vsc-debug-swatdong"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-sample-vsc-debug-swatdong": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-sample-vsc-debug-swatdong"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-sample-vsc-debug-swatdong": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-sample-vsc-debug-swatdong"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-sample-vsc-debug-swatdong": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-sample-vsc-debug-swatdong"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-sample-vsc-debug-swatdong": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-sample-vsc-debug-swatdong"
      ]
    }
  }
}

FAQ

What languages are supported?

This project supports both Python and TypeScript for implementing the MCP server.

How do I get started?

Clone the repository and follow the instructions in the README files for your chosen language.

Is there any additional setup required?

Follow the setup instructions provided in the README files for each language.

Developer tools
Debug MCP Server in VSCode — MCP Registry