UniversalVSMCP 26.0.0

dotnet tool install --global UniversalVSMCP --version 26.0.0
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local UniversalVSMCP --version 26.0.0
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=UniversalVSMCP&version=26.0.0
                    
nuke :add-package UniversalVSMCP --version 26.0.0
                    

UniversalVSMCP (UVM)

.NET Native MCP Server for Visual Studio 2026/2022

Enable AI Agents to natively control Visual Studio 2026/2022 via the Model Context Protocol (MCP).


Installation (Single Method)

dotnet tool install -g UniversalVSMCP

Run:

universal-vsmcp --stdio

Verify installation:

universal-vsmcp --help

Package: https://www.nuget.org/packages/UniversalVSMCP/


Quick Start

1. Start Visual Studio 2026

Open any solution or create a new one.

2. Run the MCP Server

universal-vsmcp --stdio

3. Configure in VS 2026

Go to Tools → Options → Environment → Extensions:

  • Add MCP Server: universal-vsmcp
  • Command: dotnet tool run --global universal-vsmcp -- --stdio

Available Tools (30 Total)

Solution Management (6)

Tool Description
get_solution_projects Get all projects in solution
get_solution_path Get solution file path
get_solution_name Get solution name
open_solution Open .sln file
close_solution Close current solution
create_solution Create new solution (workspace)

Project Management (5)

Tool Description
get_project_files Get files in a project
get_startup_projects Get startup project(s)
add_file_to_project Add file to project
set_startup_project Set startup project
get_project_properties Get project properties

File Operations (5)

Tool Description
open_file Open file in VS editor
read_file Read file content
write_file Write file content
replace_in_file Replace text in file
get_file_info Get file information

Build Operations (6)

Tool Description
build_solution Build solution
rebuild_solution Rebuild solution
clean_solution Clean solution
build_project Build specific project
get_build_errors Get build errors
get_build_configurations Get build configs

Debug Control (8)

Tool Description
start_debugging Start debugging (F5)
stop_debugging Stop debugging (Shift+F5)
toggle_breakpoint Navigate to line for breakpoint
continue_execution Continue from breakpoint (F5)
step_over Step over (F10)
step_into Step into (F11)
step_out Step out (Shift+F11)
get_debug_state Get debug state

Diagnostics (3)

Tool Description
health_check Verify server and VS connection
get_server_info Get server information
get_diagnostic_logs Get recent diagnostic logs

Command Line Options

universal-vsmcp --stdio                    # Default: stdio transport
universal-vsmcp --stdio --log-file uv.log  # With file logging
universal-vsmcp --verify                   # Verify VS connection
universal-vsmcp --help                     # Show help

Configuration

VS 2026 Configuration

Method A: Direct JSON (Recommended)

  1. Go to Tools → Options → Environment → Extensions
  2. Check "Edit user settings as JSON"
  3. Paste:
{
  "mcpServers": {
    "universal-vsmcp": {
      "command": "dotnet",
      "args": [
        "tool",
        "run",
        "--global",
        "universal-vsmcp",
        "--",
        "--stdio"
      ],
      "env": {
        "VS_AUTO_DETECT": "true"
      }
    }
  }
}

Method B: GUI

  1. Tools → Options → Environment → Extensions
  2. In MCP Server List, click Add
  3. Fill in:
    • Name: universal-vsmcp
    • Command: dotnet
    • Args: tool run --global universal-vsmcp -- --stdio

Claude Desktop / Cursor

{
  "mcpServers": {
    "vsmcp": {
      "command": "dotnet",
      "args": ["tool", "run", "--global", "universal-vsmcp", "--", "--stdio"],
      "env": {
        "VS_AUTO_DETECT": "true"
      }
    }
  }
}

Localhost Support

For local development or SSE transport:

{
  "mcpServers": {
    "vsmcp-local": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "${workspaceFolder}",
        "--",
        "--stdio"
      ],
      "transport": "stdio",
      "url": "http://localhost:6277/sse"
    }
  }
}

Troubleshooting

Verify Connection

# Check if server is installed
dotnet tool list -g

# Run health check tool from MCP client
# Or run with logging:
universal-vsmcp --stdio --log-file uv.log

Common Issues

Issue Solution
"No VS instance found" Start Visual Studio first
"Server not responding" Check UVM_LOG_FILE for errors
"Tool not found" Verify server is running
"Connection failed" Ensure VS is not running as Admin

Requirements

  • .NET 8.0 SDK or later
  • Visual Studio 2026 (18.0) or VS 2022 (17.14+)
  • Windows 10 or later

License

MIT © StarsailsClover


Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
26.0.0 0 5/31/2026
26.0.0-uvm-20260531 0 5/31/2026
1.0.0 0 5/31/2026