Microsoft.GitHubCopilot.Modernization.Mcp 1.0.1161-preview1

Prefix Reserved
This is a prerelease version of Microsoft.GitHubCopilot.Modernization.Mcp.
{
  "servers": {
    "microsoft.githubcopilot.modernization.mcp": {
      "type": "stdio",
      "command": "dnx",
      "args": ["microsoft.githubcopilot.modernization.mcp@1.0.1161-preview1", "--yes"]
    }
  }
}
                    
This package contains an MCP Server. The server can be used in VS Code by copying the generated JSON to your VS Code workspace's .vscode/mcp.json settings file.
dotnet tool install --global Microsoft.GitHubCopilot.Modernization.Mcp --version 1.0.1161-preview1
                    
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 Microsoft.GitHubCopilot.Modernization.Mcp --version 1.0.1161-preview1
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=Microsoft.GitHubCopilot.Modernization.Mcp&version=1.0.1161-preview1&prerelease
                    
nuke :add-package Microsoft.GitHubCopilot.Modernization.Mcp --version 1.0.1161-preview1
                    

Copilot modernization for .NET

An MCP (Model Context Protocol) server that provides AI-powered tools for upgrading and modernizing .NET applications. This server, combined with our modernization custom agent, enables GitHub Copilot to analyze your .NET projects and help migrate them to newer versions of .NET.

Getting Started

Option 1: VS Code Extension

The MCP server is already included in our VS Code extension. Simply install the extension and start using Copilot to modernize your .NET applications.

Option 2: GitHub Copilot CLI

To use with GitHub Copilot CLI, install the agent using dnx:

dnx Microsoft.GitHubCopilot.Modernization.Mcp --yes --prerelease -- install-agent

This installs a modernization agent to your repository's .github/agents folder.

Note: If your repository has a global.json that pins the SDK version to a version before .NET 10, follow the steps in the Troubleshooting section below before executing the above command.

Use the --global flag to install to your user profile (~/.copilot/agents) instead:

dnx Microsoft.GitHubCopilot.Modernization.Mcp --yes --prerelease -- install-agent --global

Once installed, you can invoke the agent in Copilot CLI using the /agent command:

/agent modernization

Option 3: Manual MCP Configuration

If you want to configure the MCP server manually in your MCP client, add it to your MCP configuration:

{
  "mcpServers": {
    "Modernization": {
      "command": "dnx",
      "args": [
        "Microsoft.GitHubCopilot.Modernization.Mcp",
        "--yes",
        "--prerelease"
      ]
    }
  }
}

Troubleshooting

global.json SDK Version

If your repository contains a global.json file that pins the SDK version to a version before .NET 10, dnx will fail to execute from within that repository's directory.

This issue affects the Copilot CLI experience. The VS Code extension is unaffected.

Workaround: Add or update the rollForward property in your global.json to allow rolling forward to a newer major version. The example below shows the required property; you do not need to modify your existing version value:

{
  "sdk": {
    "version": "8.0.100",
    "rollForward": "latestMajor"
  }
}

This modification has minimal impact on your project as the upgrade process will apply this change during its initial steps. Setting rollForward to latestMajor allows the .NET SDK to use the latest installed major version when the pinned version is not available, enabling the install-agent command to complete and the MCP server to launch correctly.

Requirements

  • .NET 10.0 SDK or later
  • GitHub Copilot CLI or VS Code with GitHub Copilot

Telemetry

This MCP server collects telemetry. For more information, see the Microsoft Privacy Statement.

Telemetry Configuration

Telemetry collection is on by default.

To opt out, set the environment variable APPMOD_DISABLE_TELEMETRY to true in the MCP server configuration:

{
  "mcpServers": {
    "Modernization": {
      "command": "dnx",
      "args": [
        "Microsoft.GitHubCopilot.Modernization.Mcp",
        "--yes",
        "--prerelease"
      ],
      "env": {
        "APPMOD_DISABLE_TELEMETRY": "true"
      }
    }
  }
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  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
1.0.1161-preview1 111,042 7/15/2026
1.0.1157-preview1 73,688 6/17/2026
1.0.1155-preview1 33,893 6/10/2026
1.0.1152-preview1 38,234 6/3/2026
1.0.1146-preview1 38,411 5/27/2026
1.0.1143-preview1 32,833 5/21/2026
1.0.1133-preview1 15,257 5/20/2026
1.0.1119-preview1 45,471 5/13/2026
1.0.1102-preview1 14,765 5/7/2026
1.0.1063-preview1 17,155 4/28/2026
1.0.1047-preview1 16,338 4/22/2026
1.0.1037-preview1 17,255 4/14/2026
1.0.1026-preview1 11,678 4/9/2026
1.0.1017-preview1 15,573 4/1/2026
1.0.979-preview1 22,093 3/17/2026
1.0.956-preview1 11,554 3/11/2026
1.0.949-preview1 198 3/9/2026
1.0.948-preview1 322 3/7/2026