Microsoft.AppModernization.McpServer.DotNet.Migration 1.1.0

GitHub Copilot modernization MCP Server for .NET

This MCP server implements the MCP specification and can be used alone or with the GitHub Copilot in Copilot CLI, Coding Agent, or other MCP-compatible clients.

Table of Contents

• Overview
• Installation
• Usage
  • Getting Started
  • What can you do with the GitHub Copilot modernization MCP Server?
• Support and Reference
  • Documentation
  • Feedback and Support
  • Security
  • Permissions and Risk
  • Data Collection
  • Compliance Responsibility
  • Third Party Components
  • Export Control
  • No Warranty / Limitation of Liability
  • Contributing
  • Disclaimer

Overview

GitHub Copilot modernization MCP Server for .NET provides AI-powered agents that analyze .NET applications, and migrate them to Azure.

Installation

• To use this MCP server, you must have .NET 10 Preview 6 or later installed. This version of .NET adds a command, dnx, which is used to download, install, and run the GitHub Copilot modernization MCP Server from nuget.org. To verify the .NET version, run the following command in the terminal: dotnet --info
• Configure the mcp.json file with the following:

{
  "mcpServers": {
    "DotNetAppModMcpServer-migrate": {
      "type": "local",
      "command": "dnx",
      "tools": [
        "*"
      ],
      "args": [
        "Microsoft.AppModernization.McpServer.DotNet.Migration",
        "--yes",
        "--source",
        "https://api.nuget.org/v3/index.json"
      ]
    }
  }
}

Usage

Getting Started

To get started with the GitHub Copilot modernization MCP Server, follow the comprehensive installation and setup guide in the official documentation. This guide covers configuring the MCP server with GitHub Copilot CLI, Coding Agent, and other MCP-compatible clients.

What can you do with the GitHub Copilot modernization MCP Server?

GitHub Copilot modernization MCP Server currently supports the following predefined tasks: Refer to predefined tasks

• Migrate to Managed Identity based Database on Azure, including Azure SQL DB, Azure SQL MI and Azure PostgreSQL

  Modernize your data layer by migrating from on-premises or legacy databases (such as DB2, Oracle DB, or SQL Server) to Azure SQL DB, Azure SQL Managed Instance or Azure PostgreSQL, using secure managed identity authentication.

• Migrate to Azure File Storage

  Move file I/O operations from the local file system to Azure File Storage for scalable, cloud-based file management.

• Migrate to Azure Blob Storage

  Replace on-premises or cross-cloud object storage, or local file system file I/O, with Azure Blob Storage for unstructured data.

• Migrate to Microsoft Entra ID

  Transition authentication and authorization from Windows Active Directory to Microsoft Entra ID (formerly Azure AD) for modern identity management.

• Migrate to secured credentials with Managed Identity and Azure Key Vault

  Replace plaintext credentials in configuration or code with secure, managed identities and Azure Key Vault for secrets management.

• Migrate to Azure Service Bus

  Move from legacy or third-party message queues (such as MSMQ or RabbitMQ) or Amazon SQS (AWS Simple Queue Service) to Azure Service Bus for reliable, cloud-based messaging.

• Migrate to Azure Communication Service email

  Replace direct SMTP email sending with Azure Communication Service for scalable, secure email delivery.

• Migrate to Confluent Cloud/Azure Event Hub for Apache Kafka

  Transition from local or on-premises Kafka to managed event streaming with Confluent Cloud or Azure Event Hubs.

• Migrate to OpenTelemetry on Azure

  Transition from local logging frameworks like log4net, serilog, windows event log to OpenTelemetry on Azure.

• Migrate to Azure Cache for Redis

  Replace in-memory or local Redis cache implementations with Azure Cache for Redis for high availability, scalability, and enterprise-grade security.

Support and Reference

Documentation

• See our official documentation on learn.microsoft.com to learn how to use the GitHub Copilot modernization MCP Server to modernize your .NET applications through natural language commands from AI agents and other types of clients.

Feedback and Support

• Check the FAQ for common questions and issues with the GitHub Copilot modernization MCP Server.
• We're building this in the open. Your feedback is much appreciated, and will help us shape the future of the GitHub Copilot modernization MCP Server.
  • 👉 Open an issue in the public GitHub repository — we’d love to hear from you!

Security

TBD - Coming soon!

Permissions and Risk

TBD - Coming soon!

Data Collection

The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's privacy statement. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.

Telemetry Configuration

Telemetry collection is on by default.

To opt out, set the environment variable APPMOD_MCP_COLLECT_TELEMETRY to false in your environment.

Compliance Responsibility

This MCP server may interact with clients and services outside Microsoft compliance boundaries. You are responsible for ensuring that any integration complies with applicable organizational, regulatory, and contractual requirements.

Third Party Components

This MCP server may use or depend on third party components. You are responsible for reviewing and complying with the licenses and security posture of any third-party components.

Export Control

Use of this software must comply with all applicable export laws and regulations, including U.S. Export Administration Regulations and local jurisdiction requirements.

No Warranty / Limitation of Liability

This software is provided “as is” without warranties or conditions of any kind, either express or implied. Microsoft shall not be liable for any damages arising from use, misuse, or misconfiguration of this software.

Contributing

TBD - Coming soon!

Disclaimer

Unless otherwise permitted under applicable license(s), users may not decompile, modify, repackage, or redistribute any assets, prompts, or internal tools provided as part of this product without prior written consent from Microsoft.