Sampledotnetmcpserver

io.github.timheuerPublished by GitHub account timheuerv0.1.57-betaUpdated Oct 24, 2026

Sample .NET MCP Server

VerifiedSTDIODesktop onlyLocation & Lifestyle Developer Tools

Server details

Identifier: io.github.timheuer/sampledotnetmcpserver
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account timheuer for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.timheuer%2Fsampledotnetmcpserver.svg)](https://sourceweft.com/mcp/io.github.timheuer%2Fsampledotnetmcpserver?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

A reference .NET MCP server sample that exposes demo tools for random numbers, greetings and US zip-code weather, meant for learning how to build MCP servers…

What you can do: Generate random integers within a specified range
Say hello or goodbye to a given name
Look up current weather for a US zip code
Get a multi-day weather forecast for a US zip code
When to use it: Useful if you want a working example of an MCP server written in C# with the ModelContextProtocol SDK, to test MCP client or IDE integration, or to see how tools are registered and packaged as a NuGet server. It is a demonstration project rather than a production tool.
Requirements: Runs locally over stdio as a .NET process; the .NET SDK is needed to run from source, or the dnx tool to launch the published NuGet package. No authentication, environment variables or headers are declared. Weather tools rely on the wttr.in API, so network access is needed for them.

Before you install

The README states the project is for demonstration and reference purposes only, so do not rely on it for real work. Weather lookups send the zip code to the third-party wttr.in service. The README's NuGet example uses a different package id than the manifest, so verify the package before installing.

Installation

In SourceWeft

Open Sampledotnetmcpserver in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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:

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

json

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

{  "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):

json

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

{  "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.

Source: README.md at commit bf81344

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.1.57-betaLatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts