csharp-mcp-server-generator

Name: csharp-mcp-server-generator
Author: github

Scaffold a production-ready C# MCP server with tools, logging, and proper configuration. Generates a complete .NET 8.0+ console application with Host builder pattern, DI configuration, and stdio transport setup Includes automatic tool discovery via WithToolsFromAssembly() , attribute-based tool definitions, and structured logging routed to stderr Provides example tool implementations with parameter validation, async support, and McpProtocolException error handling Covers project structure, NuGet dependencies, XML documentation, nullable reference types, and testing guidance with MCP client examples

INSTALLATION

npx skills add https://github.com/github/awesome-copilot --skill csharp-mcp-server-generator

Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

Generate C# MCP Server

Create a complete Model Context Protocol (MCP) server in C# with the following specifications:

Requirements

Project Structure: Create a new C# console application with proper directory structure

NuGet Packages: Include ModelContextProtocol (prerelease) and Microsoft.Extensions.Hosting

Logging Configuration: Configure all logs to stderr to avoid interfering with stdio transport

Server Setup: Use the Host builder pattern with proper DI configuration

Tools: Create at least one useful tool with proper attributes and descriptions

Error Handling: Include proper error handling and validation

Implementation Details

Basic Project Setup

Use .NET 8.0 or later

Create a console application

Add necessary NuGet packages with --prerelease flag

Configure logging to stderr

Server Configuration

Use Host.CreateApplicationBuilder for DI and lifecycle management

Configure AddMcpServer() with stdio transport

Use WithToolsFromAssembly() for automatic tool discovery

Ensure the server runs with RunAsync()

Tool Implementation

Use [McpServerToolType] attribute on tool classes

Use [McpServerTool] attribute on tool methods

Add [Description] attributes to tools and parameters

Support async operations where appropriate

Include proper parameter validation

Code Quality

Follow C# naming conventions

Include XML documentation comments

Use nullable reference types

Implement proper error handling with McpProtocolException

Use structured logging for debugging

Example Tool Types to Consider

File operations (read, write, search)

Data processing (transform, validate, analyze)

External API integrations (HTTP requests)

System operations (execute commands, check status)

Database operations (query, update)

Testing Guidance

Explain how to run the server

Provide example commands to test with MCP clients

Include troubleshooting tips

Generate a complete, production-ready MCP server with comprehensive documentation and error handling.