williamlimasilva/csharp-mcp-server-generator

Generate C# MCP Server

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

Requirements

1. Project Structure: Create a new C# console application with proper directory structure
2. NuGet Packages: Include ModelContextProtocol (prerelease) and Microsoft.Extensions.Hosting
3. Logging Configuration: Configure all logs to stderr to avoid interfering with stdio transport
4. Server Setup: Use the Host builder pattern with proper DI configuration
5. Tools: Create at least one useful tool with proper attributes and descriptions
6. 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.