Remote MCP Server using .NET SDK with VS Code Support

This project is a C# implementation of a Model Context Protocol (MCP) server that exposes weather forecast and health check tools. This server integrates with GitHub Copilot in VS Code, allowing AI assistants to call your custom tools.

Overview

This project demonstrates how to build an HTTP-based MCP server using the .NET SDK. The server exposes two tools:

• ping: Health check with optional message echo
• get_weather: Weather forecast retrieval for cities

Prerequisites

• .NET 8.0 SDK or later
• Visual Studio Code
• GitHub Copilot extension (with MCP support)
• C# Dev Kit extension (recommended)

Project Structure

remote-MCP-servers-using-dotnet-sdk-vs-code-support/
├── src/
│   └── McpServer/
│       └── McpServer/
│           ├── McpServerTools.cs      # Tool definitions
│           ├── Program.cs             # Server entry point
│           └── McpServer.csproj       # Project file
├── .vscode/
│   └── mcp.json                       # MCP server configuration
└── README.md

Getting Started

1. Build and Run the Server

Open a terminal in the project root and run:

dotnet run --project .\src\McpServer\McpServer\McpServer.csproj

You should see output indicating the server is running:

info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://0.0.0.0:8081

2. Configure VS Code

Create or verify .vscode/mcp.json in your workspace:

{
  "servers": {
    "local-mcp-server": {
      "url": "http://0.0.0.0:8081/mcp",
      "type": "http"
    }
  }
}

3. Connect to the Server in VS Code

1. Open Command Palette: Press Ctrl + Shift + P (Windows/Linux) or Cmd + Shift + P (Mac)

2. List MCP Servers: Type and select List MCP Servers

3. Select your server: Choose local-mcp-server from the list

4. Available actions:

   • Start: Starts the MCP server connection
   • Stop: Stops the MCP server connection
   • Restart: Restarts the MCP server connection
   • Show Configuration: Displays the server configuration from mcp.json
   • Show Output: Opens the output panel showing server logs and tool discovery
   • Configure Model Access: Configures which AI models can access this MCP server

4. Verify Server Status

After starting the server, check the output panel for:

[info] Connection state: Running
[info] Discovered 2 tools

✅ If you see this, the server is ready to use!

⚠️ If you see warnings about tool descriptions, ensure all methods in McpServerTools.cs have [Description] attributes.

Testing the MCP Server

Ping Test

Once the server is running, test it using the ping tool in GitHub Copilot Chat:

Open chat windows and start conversation

Test 1: Basic Health Check

Ask: "Ping the server"
Expected Response: ✅ MCP server is alive.

Ask your question

Approve and get result

Test 2: Echo Message

Ask: "Ping the server with message 'Hello MCP'"
Expected Response: ✅ MCP server received: Hello MCP

Weather Forecast Test

Test the weather forecast functionality:

Ask: "What's the weather in London?"
Expected Response: Weather forecast data for London

Ask your question

Approve and get result

Available Tools

The `local-mcp-serve

... View full README on GitHub