Quickmcp

🚀 QuickMCP

QuickMCP is a powerful .NET toolkit designed to simplify the creation and deployment of Model Context Protocol (MCP) servers. It enables developers to quickly generate servers from OpenAPI, Swagger, or Google discovery specifications, reducing boilerplate code and accelerating the development process.

🚀 Quick Start

QuickMCP is a powerful .NET toolkit that simplifies the creation and deployment of Model Context Protocol (MCP) servers. It allows developers to rapidly generate servers from OpenAPI, Swagger, or Google discovery specifications, thereby reducing boilerplate code and speeding up the development process.

✨ Features

• Generate .NET MCP servers from OpenAPI/Swagger/Google discovery specifications.
• A highly configurable .NET library with CLI utilities for rapid deployment.
• Multiple configuration methods (supports configuration options or method chaining).
• Comprehensive authentication support:
  • API Key, Basic, Bearer Token, OAuth 2.0, custom headers.
  • Provides an interface for custom authentication implementation.
• Configuration generation tools with path filtering, HTTP customization, error handling, and logging capabilities.
• Seamless integration with MCP clients (e.g., Claude Desktop).
• Supports configuration files and full asynchronous/await functionality.

📦 Installation

CLI Installation

dotnet tool install -g QuickMCP.CLI

Library Installation

dotnet add package QuickMCP

💻 Usage Examples

Basic CLI Usage

# Serve directly from an OpenAPI specification
quickmcp serve --spec-url https://petstore.swagger.io/v2/swagger.json

# Generate a configuration file
quickmcp build config --spec-url https://petstore.swagger.io/v2/swagger.json --output-path ./config

# Start the service using a configuration file
quickmcp serve --config-path ./config/mcp_server_config.json

# Add authentication to the configuration
quickmcp build config --spec-url https://api.example.com/swagger.json --auth bearer

# Add a server configuration for quick access
quickmcp add server /path/to/config.json -n MyServer

# List all stored server configurations
quickmcp list server

# Start an installed server configuration
quickmcp serve -i myServer

# Delete a specified server configuration
quickmcp delete server MyServer

Library Integration Example

// Create and configure a server instance
var serverInfoBuilder = McpServerInfoBuilder.ForOpenApi()
    .FromUrl("https://petstore.swagger.io/v2/swagger.json")
    .WithBaseUrl("https://petstore.swagger.io")
    .AddDefaultHeader("User-Agent", "QuickMCP 客户端")
    .AddAuthentication(new ApiKeyAuthenticator("your-api-key", "X-API-Key", "header"));

// Build the server information
var serverInfo = await serverInfoBuilder.BuildAsync();

// Integrate into the official MCP C# SDK
var hostBuilder = Host.CreateApplicationBuilder();

var mcpBuilder = hostBuilder.Services
    .AddMcpServer()
    .WithQuickMCP(mcpServerInfo)
    .WithStdioServerTransport();

// Start the server
await hostBuilder.Build().RunAsync();

Integration with MCP Clients

{
  "servers": {
    "default": {
      "url": "http://localhost:8080"
    }
  }
}

Or:

{
  "configuration": {
    "logging": {
      "level": "debug"
    }
  }
}

📚 Documentation

For further information on how to use QuickMCP, please refer to the following documentation:

• Installation Guide
• Basic CLI Usage
• Library Integration Example
• Integration with MCP Clients

We hope you can easily leverage QuickMCP to enhance your development efficiency. Your feedback and suggestions are welcome.