English Français العربية

io.github.timheuer/sampledotnetmcpserver

Official registry Other

Sample .NET MCP Server

Source code Documentation

What can you do with io.github.timheuer/sampledotnetmcpserver?

  • Implements the MCP protocol using stdio transport
  • Provides multiple sample tools:
  • Ready to be packed and published as a NuGet MCP server
  • Example configuration files and metadata included

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NUGET package TimHeuer.SampleDotnetMcpServer
Claude Code 
claude mcp add sampledotnetmcpserver -- dnx TimHeuer.SampleDotnetMcpServer@0.1.57-beta --yes
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "sampledotnetmcpserver": {
            "command": "dnx",
            "args": [
                "TimHeuer.SampleDotnetMcpServer@0.1.57-beta",
                "--yes"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. SampleDotnetMcpServer
  2. What is this?
  3. Features
  4. How to use
  5. Project structure
  6. Learn more

SampleDotnetMcpServer

This project is a sample implementation of a Model Context Protocol (MCP) server in .NET, designed to demonstrate how to build, run, and publish an MCP server using C# and the ModelContextProtocol SDK.

mcp-name: io.github.timheuer/sampledotnetmcpserver

What is this?

SampleDotnetMcpServer is a reference MCP server for .NET, showing how to:

  • Implement MCP tools in C# (see Tools/RandomNumberTools.cs, Tools/SayHelloName.cs, Tools/WeatherTools.cs)
  • Register tools and configure the MCP server transport (see Program.cs)
  • Package and publish the server as a NuGet package for use in IDEs like VS Code and Visual Studio

The included tools demonstrate various MCP capabilities:

  • get_random_number: Generates random numbers within a specified range
  • say_hello_name and say_goodbye_name: Simple greeting tools
  • get_weather_by_zip_code: Gets current weather information for any US zip code
  • get_weather_forecast: Gets a multi-day weather forecast for any US zip code

Features

  • Implements the MCP protocol using stdio transport
  • Provides multiple sample tools:
    • get_random_number: Returns a random integer in a specified range
    • say_hello_name and say_goodbye_name: Simple greeting tools
    • get_weather_by_zip_code: Gets current weather for any US zip code using wttr.in API
    • get_weather_forecast: Gets multi-day weather forecast for any US zip code
  • Ready to be packed and published as a NuGet MCP server
  • Example configuration files and metadata included

How to use

Run locally

You can run the MCP server directly from source for development and testing:

dotnet run --project .

Or configure your IDE to use the following MCP server definition:

{
  "servers": {
    "SampleDotnetMcpServer": {
      "type": "stdio",
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "<PATH TO PROJECT DIRECTORY>"
      ]
    }
  }
}
Test the MCP server

Once running, you can use Copilot Chat or any MCP client to invoke the available tools:

Weather Tools:

  • Ask: "What's the weather like in 90210?" to get current weather
  • Ask: "Give me a 3-day forecast for 10001" to get a weather forecast
  • Ask: "Check the weather in 60601" to test with Chicago's zip code

Other Tools:

  • Ask: "Give me 3 random numbers" to use the random number generator
  • Ask: "Say hello to John" to use the greeting tools
Publish to NuGet.org

CI handles publishing to NuGet, using NuGet Trusted Publishing for the key and automatic versioning using Nerdbank.GitVersioning.

Use from NuGet.org

After publishing, configure your IDE to use the MCP server from NuGet.org. Example configuration (replace package id and version):

{
  "servers": {
    "SampleDotnetMcpServer": {
      "type": "stdio",
      "command": "dnx",
      "args": [
        "TimHeuer.SampleMcpServer",
        "--version",
        "0.1.0-beta",
        "--yes"
      ]
    }
  }
}

Project structure

  • Program.cs: MCP server entry point and configuration
  • Tools/RandomNumberTools.cs: Example MCP tool for generating random numbers
  • Tools/SayHelloName.cs: Example MCP tools for greetings
  • Tools/WeatherTools.cs: Weather-related MCP tools for checking weather by zip code
  • .mcp/server.json: MCP server metadata and NuGet package info
  • SampleDotnetMcpServer.csproj: Project and NuGet packaging configuration

Learn more

This project is for demonstration and reference purposes only. For feedback or contributions, see the GitHub repository.

Frequently asked questions

What is io.github.timheuer/sampledotnetmcpserver?

Sample .NET MCP Server

How do I install io.github.timheuer/sampledotnetmcpserver?

It runs on your machine. In Claude Code: claude mcp add sampledotnetmcpserver -- dnx TimHeuer.SampleDotnetMcpServer@0.1.57-beta --yes. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.timheuer/sampledotnetmcpserver need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.timheuer/sampledotnetmcpserver open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.timheuer/sampledotnetmcpserver?

It is published by timheuer. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.