QuickMCP

QuickMCP

使用 .NET 和 OpenAPI、Swagger 或 Google Discovery 规范，轻松构建并运行 Model Context Protocol（MCP）服务。

简介

QuickMCP 是一款功能强大的 .NET 工具包，旨在简化 Model Context Protocol（MCP）服务的创建和部署。它支持开发者根据 OpenAPI、Swagger 或 Google Discovery 规范快速生成服务，减少样板代码并加快开发进度。

功能

• 根据 OpenAPI/Swagger/Google Discovery 规范生成 .NET MCP 服务
• 构建 Claude Desktop 扩展（.mcpb），并利用 AI 生成元数据
• 高度可配置的 .NET 库，附带便于快速部署的 CLI 工具
• 支持多种配置方式（配置选项或方法链式调用）
• 全面的身份验证支持：
  • API Key、Basic、Bearer Token、OAuth 2.0、自定义 Header
  • 自定义身份验证实现接口
• 生成工具，支持路径筛选、HTTP 自定义、错误处理和日志记录
• 与 Claude Desktop 等 MCP 客户端无缝集成
• 支持配置文件，并全面支持 async/await
• 使用 Google Gemini 为扩展说明生成 AI 元数据

安装

安装 CLI

dotnet tool install -g QuickMCP.CLI

安装库

dotnet add package QuickMCP

快速开始

CLI 基本用法

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

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

# Build a Claude Desktop extension (.mcpb) with AI-generated metadata
quickmcp build ce --spec-url https://api.example.com/swagger.json -m --author-name "Your Company"

# Build extension from existing config file
quickmcp build ce -c path/to/config.json -m -k YOUR_GEMINI_API_KEY

# Serve using a configuration file
quickmcp serve --config-path ./config/mcp_server_config.json

# Add authentication to your 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 available servers
quickmcp list server

# Serve installed server
quickmcp serve -i myServer

# Remove a stored server configuration
quickmcp delete server MyServer

库集成示例

// Create and configure a server
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"));

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

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

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

//Run Server
await hostBuilder.Build().RunAsync();  

与 MCP 客户端集成

{
  "mcpServers": {
    "petStore": {
      "command": "quickmcp",
      "args": ["serve", "-c", "path/to/config.json"]
    }
  }
}

或使用已安装的服务

{
  "mcpServers": {
    "petStore": {
      "command": "quickmcp",
      "args": ["serve", "-i", "server_id"]
    }
  }
}

文档

有关以下主题的详细文档，请参阅 Wiki：

• 库实现指南
• 身份验证选项
• 配置方式
• CLI 用法
• Claude Desktop 扩展构建器

贡献

欢迎贡献！提交 PR 或 Issues，为项目贡献力量。

许可证

QuickMCP 根据 MIT License 授权。详情请参阅 LICENSE 文件。