QuickMCP

基本能力

产品定位

QuickMCP是一个用于快速构建和部署MCP服务器的.NET工具包，支持从OpenAPI、Swagger或Google Discovery规范生成服务器。

核心功能

• 从OpenAPI/Swagger/Google Discovery规范生成.NET MCP服务器
• 高度可配置的.NET库，带有CLI工具用于快速部署
• 多种配置方法（配置选项或方法链）
• 全面的认证支持：
• API Key、Basic、Bearer Token、OAuth 2.0、自定义Header
• 自定义认证实现接口
• 生成工具，包括路径过滤、HTTP定制、错误处理和日志记录
• 与MCP客户端（如Claude Desktop）无缝集成
• 配置文件支持和完整的async/await能力

适用场景

• 快速从现有API规范生成MCP服务器
• 需要高度可配置和可扩展的MCP服务器开发
• 需要多种认证方式的API服务
• 与现有MCP客户端集成

工具列表

• QuickMCP.CLI: 命令行工具，用于快速部署和配置MCP服务器
• QuickMCP: .NET库，用于在代码中集成和定制MCP服务器

常见问题解答

• 详细文档请参考项目Wiki
• 贡献指南和许可证信息在README中提供

使用教程

使用依赖

• 需要安装.NET SDK

安装教程

CLI安装

dotnet tool install -g QuickMCP.CLI

库安装

dotnet add package QuickMCP

调试方式

基本CLI使用

# 直接从OpenAPI规范服务
quickmcp serve --spec-url https://petstore.swagger.io/v2/swagger.json

# 构建配置文件
quickmcp build config --spec-url https://petstore.swagger.io/v2/swagger.json --output-path ./config

# 使用配置文件服务
quickmcp serve --config-path ./config/mcp_server_config.json

# 向配置添加认证
quickmcp build config --spec-url https://api.example.com/swagger.json --auth bearer

库集成示例

// 创建并配置服务器
var serverInfoBuilder = McpServerInfoBuilder.ForOpenApi()
    .FromUrl("https://petstore.swagger.io/v2/swagger.json")
    .WithBaseUrl("https://petstore.swagger.io")
    .AddDefaultHeader("User-Agent", "QuickMCP Client")
    .AddAuthentication(new ApiKeyAuthenticator("your-api-key", "X-API-Key", "header"));

// 构建服务器信息
var serverInfo = await serverInfoBuilder.BuildAsync();

// 与官方MCP C# SDK集成
var hostBuilder = Host.CreateApplicationBuilder();

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

// 运行服务器
await hostBuilder.Build().RunAsync();

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。