QuickMCP

使用 .NET 轻松构建和部署基于 OpenAPI、Swagger 或 Google Discovery 规范的模型上下文协议（MCP）服务器。

简介

QuickMCP 是一个强大的 .NET 工具包，旨在简化模型上下文协议（MCP）服务器的创建和部署。它允许开发者快速生成服务器，从 OpenAPI、Swagger 或 Google Discovery 规范中减少样板代码并加速开发。

特性

• 从 OpenAPI/Swagger/Google Discovery 规范生成 .NET MCP 服务器
• 使用 AI 功能生成元数据来构建 Claude 桌面扩展（.mcpb）
• 高度可配置的 .NET 库，带有 CLI 工具以实现快速部署
• 多种配置方法（配置选项或方法链）
• 全面的身份验证支持：
  • API 密钥、基本身份验证、Bearer Token、OAuth 2.0、自定义头部
  • 自定义身份验证实现接口
• 带有路径过滤、HTTP 定制、错误处理和日志记录的工具生成
• 与 Claude 桌面等 MCP 客户端无缝集成
• 支持配置文件和完整的异步/等待功能
• 使用 Google Gemini 的 AI 功能生成扩展描述的元数据

安装

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

# 使用 AI 生成的元数据构建 Claude 桌面扩展（.mcpb）
quickmcp build ce --spec-url https://api.example.com/swagger.json -m --author-name "Your Company"

# 从现有配置文件构建扩展
quickmcp build ce -c path/to/config.json -m -k YOUR_GEMINI_API_KEY

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

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

# 添加服务器配置以快速访问
quickmcp add server /path/to/config.json -n MyServer

# 列出可用服务器
quickmcp list server

# 提供已安装的服务器
quickmcp serve -i myServer

# 删除存储的服务器配置
quickmcp delete server MyServer

库集成示例

// 创建并配置服务器
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();

与 MCP 客户端集成

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

或使用已安装的服务器

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

文档

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

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

贡献

我们欢迎贡献！提交 PR 或问题以参与项目。

许可证

QuickMCP 在 MIT 许可证下发布。详情见LICENSE文件。