WhileYouWait 0.1.3-beta

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
This is a prerelease version of WhileYouWait. 
{
  "servers": {
    "WhileYouWait": {
      "type": "stdio",
      "command": "dnx",
      "args": ["WhileYouWait@0.1.3-beta", "--yes"]
    }
  }
}
This package contains an MCP Server. The server can be used in VS Code by copying the generated JSON to your VS Code workspace's .vscode/mcp.json settings file. 
dotnet tool install --global WhileYouWait --version 0.1.3-beta
This package contains a .NET tool you can call from the shell/command line. 
dotnet new tool-manifest
                    


                            if you are setting up this repo
                        

                    

                
dotnet tool install --local WhileYouWait --version 0.1.3-beta
This package contains a .NET tool you can call from the shell/command line. 
#tool dotnet:?package=WhileYouWait&version=0.1.3-beta&prerelease
                    


                    

                
nuke :add-package WhileYouWait --version 0.1.3-beta

WhileYouWait 😄

An MCP (Model Context Protocol) server that fetches and displays random xkcd comics to give you fun breaks while coding!

Features

  • Random xkcd Comics: Fetches a random comic from the entire xkcd archive
  • Specific Comics: Request a specific comic by number
  • Auto-display in VS Code: Comics open directly in a VS Code document tab
  • Comic Metadata: Shows title, alt text, and publication date

Prerequisites

Quick Start

  1. The .vscode/mcp.json file is already configured for local development
  2. Restart VS Code to load the MCP server
  3. Ask Copilot: "Show me an xkcd comic" or "I need a break"

Available Tool

ShowNeckExercise

Fetches and displays an xkcd comic with its metadata.

Parameters:

  • comicNumber (optional): Specific comic number to show (e.g., 614). If not specified, shows a random comic.

Example prompts:

  • "Show me an xkcd comic"
  • "I need a fun break"
  • "Show me xkcd comic 303"
  • "Random xkcd please"

Project Structure

├── Program.cs              # MCP server entry point

├── Program.cs # MCP server entry point ├── Tools/ │ └── NeckExerciseTool.cs # xkcd comic fetcher MCP tool ├── .vscode/mcp.json # VS Code MCP configuration └── .mcp/server.json # MCP server metadata for NuGet


## Local Development

To test this MCP server locally:

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

Testing the MCP Server

Once configured, ask Copilot Chat to show you an xkcd comic. It will use the ShowNeckExercise tool to fetch and display a random comic with its title, alt text, and publication date. The comic image will open directly in a VS Code document tab!

Publishing to NuGet.org

  1. Run dotnet pack -c Release to create the NuGet package
  2. Publish to NuGet.org with dotnet nuget push bin/Release/*.nupkg --api-key <your-api-key> --source https://api.nuget.org/v3/index.json

Using the MCP Server from NuGet.org

Once the MCP server package is published to NuGet.org, you can configure it in your preferred IDE. Both VS Code and Visual Studio use the dnx command to download and install the MCP server package from NuGet.org.

  • VS Code: Create a <WORKSPACE DIRECTORY>/.vscode/mcp.json file
  • Visual Studio: Create a <SOLUTION DIRECTORY>\.mcp.json file

For both VS Code and Visual Studio, the configuration file uses the following server definition:

{
  "servers": {
    "NeckRollMcp": {
      "type": "stdio",
      "command": "dnx",
      "args": [
        "<your package ID here>",
        "--version",
        "<your package version here>",
        "--yes"
      ]
    }
  }
}

More information

.NET MCP servers use the ModelContextProtocol C# SDK. For more information about MCP:

Refer to the VS Code or Visual Studio documentation for more information on configuring and using MCP servers:

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
0.1.3-beta 493 11/25/2025
0.1.2-beta 465 11/25/2025
0.1.1-beta 456 11/25/2025