English Français العربية

io.github.joelverhagen/Knapcode.SampleMcpServer

Official registry Developer tools

A sample MCP server using the MCP C# SDK. Generates random numbers and random weather.

Source code Documentation

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 Knapcode.SampleMcpServer
Claude Code 
claude mcp add knapcode-samplemcpserver -e 'WEATHER_CHOICES=<WEATHER_CHOICES>' -- dnx Knapcode.SampleMcpServer@0.7.0-beta --yes mcp start
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "knapcode-samplemcpserver": {
            "command": "dnx",
            "args": [
                "Knapcode.SampleMcpServer@0.7.0-beta",
                "--yes",
                "mcp",
                "start"
            ],
            "env": {
                "WEATHER_CHOICES": "<WEATHER_CHOICES>"
            }
        }
    }
}

Environment variables

  • WEATHER_CHOICES

Documentation

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

Contents
  1. MCP Server - Knapcode.SampleMcpServer
  2. Checklist before publishing to NuGet.org
  3. Using the MCP Server in VS Code
  4. Developing locally in VS Code

MCP Server - Knapcode.SampleMcpServer

This README was created using the C# MCP server template project. It demonstrates how you can easily create an MCP server using C# and then package it in a NuGet package.

See aka.ms/nuget/mcp/guide for the full guide.

Checklist before publishing to NuGet.org

  • Test the MCP server locally using the steps below.
  • Update the package metadata in the .csproj file, in particular the <PackageId>.
  • Update .mcp/server.json to declare your MCP server's inputs.
  • Pack the project using dotnet pack.

The bin/Release directory will contain the package file (.nupkg), which can be published to NuGet.org.

Using the MCP Server in VS Code

Once the MCP server package is published to NuGet.org, you can use the following VS Code user configuration to download and install the MCP server package. See Use MCP servers in VS Code (Preview) for more information about using MCP servers in VS Code.

{
  "mcp": {
    "servers": {
      "Knapcode.SampleMcpServer": {
        "type": "stdio",
        "command": "dnx",
        "args": [
          "Knapcode.SampleMcpServer@0.4.0-beta",
          "--yes",
          "--",
          "mcp",
          "start"
        ],
        "env": {
          "WEATHER_CHOICES": "sunny,humid,freezing"
        }
      }
    }
  }
}

Now you can ask Copilot Chat for a random number, for example, Give me 3 random numbers. It should prompt you to use the get_random_number tool on the Knapcode.SampleMcpServer MCP server and show you the results.

Developing locally in VS Code

To test this MCP server from source code (locally) without using a built MCP server package, create a .vscode/mcp.json file (a VS Code workspace settings file) in your project directory and add the following configuration:

{
  "servers": {
    "Knapcode.SampleMcpServer": {
      "type": "stdio",
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "<RELATIVE PATH TO PROJECT DIRECTORY>",
        "--",
        "mcp",
        "start"
      ],
      "env": {
        "WEATHER_CHOICES": "sunny,humid,freezing"
      }
    }
  }
}

Alternatively, you can configure your VS Code user settings to use your local project:

{
  "mcp": {
    "servers": {
      "Knapcode.SampleMcpServer": {
        "type": "stdio",
        "command": "dotnet",
        "args": [
          "run",
          "--project",
          "<FULL PATH TO PROJECT DIRECTORY>"
          "--",
          "mcp",
          "start"
        ]
      },
      "env": {
        "WEATHER_CHOICES": "sunny,humid,freezing"
      }
    }
  }
}

Frequently asked questions

What is io.github.joelverhagen/Knapcode.SampleMcpServer?

A sample MCP server using the MCP C# SDK. Generates random numbers and random weather.

How do I install io.github.joelverhagen/Knapcode.SampleMcpServer?

It runs on your machine. In Claude Code: claude mcp add knapcode-samplemcpserver -e 'WEATHER_CHOICES=<WEATHER_CHOICES>' -- dnx Knapcode.SampleMcpServer@0.7.0-beta --yes mcp start. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.joelverhagen/Knapcode.SampleMcpServer 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.joelverhagen/Knapcode.SampleMcpServer open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.joelverhagen/Knapcode.SampleMcpServer?

It is published by joelverhagen. 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.