MCP .NET Client Server

Clone the sample project to your local machine so you have both the C# and TypeScript versions available.

git clone https://github.com/qmatteoq/MCP-Client-Server-for-agents.git
cd MCP-Client-Server-for-agents

Open the project in VS Code and start the Azurite Table Service emulator via the status bar button or the command palette (Ctrl+Shift+P → 'Azurite: Start Table Service'). This emulates the Azure Table Storage used to persist vacation data.

Navigate to the Stdio folder and start the .NET console server. Any MCP client can connect by pointing to this command and arguments.

dotnet run --project src/csharp/Stdio/MCP.Stdio.Server/MCP.Stdio.Server.csproj

Add the server to your MCP client configuration using the dotnet run command as the server process. The server exposes tools for listing employees, querying vacation balances, and charging vacation days.

{
  "mcpServers": {
    "mcp-dotnet-sample": {
      "command": "dotnet",
      "args": ["run", "--project", "/path/to/src/csharp/Stdio/MCP.Stdio.Server/MCP.Stdio.Server.csproj"]
    }
  }
}

For the full HTTP Streaming demo with a Blazor UI, update appsettings.json with your Azure OpenAI connection string, then start the Aspire host. A browser window opens showing the dashboard.

# Update appsettings.json openAiConnectionName first, then:
dotnet run --project MCP.SSE.AppHost/MCP.SSE.AppHost.csproj

If you prefer the TypeScript variant of the stdio server, install dependencies and build before running.

cd src/ts/stdio/server
npm install
npm run build