QuickMCP是一个强大的.NET工具包,旨在简化Model Context Protocol (MCP) 服务器的创建和部署。它允许开发者快速从OpenAPI、Swagger或Google Discovery规范生成MCP服务器,从而减少样板代码并加速开发。

主要功能点

  • 从OpenAPI/Swagger/Google Discovery规范生成.NET MCP服务器实现。
  • 高度可配置的.NET库和命令行工具,支持快速部署。
  • 支持多种认证方式(API Key, Basic, Bearer Token, OAuth 2.0, 自定义Header)。
  • 根据API规范自动生成MCP工具(对应API端点)、资源(对应API Schema)和Prompt模板(通用及资源示例)。
  • 通过CLI或库进行集成,轻松与Claude Desktop等MCP客户端连接。
  • 支持配置文件、路径过滤、HTTP定制等高级功能。

安装

通过.NET Tool安装CLI工具:

dotnet tool install -g QuickMCP.CLI

作为库安装到.NET项目中:

dotnet add package QuickMCP

服务器配置(用于MCP客户端)

MCP客户端需要配置启动MCP服务器进程的命令和参数。QuickMCP服务器通常通过命令行启动。

{
  "mcpServers": {
    "myServerName": {
      "command": "quickmcp",
      "args": ["serve", "-i", "myServerId"],
      "description": "可选: 服务器的描述"
    }
  }
}

或直接使用配置文件:

{
  "mcpServers": {
    "myServerName": {
      "command": "quickmcp",
      "args": ["serve", "-c", "/path/to/your/config.json"],
      "description": "可选: 服务器的描述"
    }
  }
}
  • 'myServerName': 在客户端中显示的服务器名称(可自定义)。
  • 'command': 启动QuickMCP服务器的可执行文件路径,通常是'quickmcp'。
  • 'args': 传递给'quickmcp'命令的参数。
    • 'serve': 启动服务器的子命令。
    • '-i myServerId': 使用之前通过 'quickmcp add server' 命令安装的服务器配置。'myServerId' 是安装时指定的ID。
    • '-c /path/to/your/config.json': 使用指定的配置文件启动服务器。'/path/to/your/config.json' 是配置文件的实际路径。
    • 您还可以直接在'args'中提供API规范URL或路径等信息,详见CLI文档。

基本使用方法

  1. 构建配置文件: 从OpenAPI规范生成配置文件:

    quickmcp build config --spec-url https://petstore.swagger.io/v2/swagger.json --output-path ./petstore_mcp

    这会在 './petstore_mcp' 目录下生成 'petstore_mcp_config.json' 文件以及API规范文件。

  2. 安装服务器配置(可选,方便CLI启动): 将生成的配置文件安装到本地QuickMCP配置目录:

    quickmcp add server ./petstore_mcp/petstore_mcp_config.json -n PetstoreAPI

    '-n PetstoreAPI' 指定了服务器的别名/ID为 'petstoreapi'。

  3. 启动MCP服务器: 使用安装的服务器配置启动:

    quickmcp serve -i petstoreapi

    或直接使用配置文件启动:

    quickmcp serve -c ./petstore_mcp/petstore_mcp_config.json

    服务器将通过STDIO协议启动(默认),等待MCP客户端连接并发送JSON-RPC请求。您也可以指定 '--host-protocol http' 来启动HTTP服务器。

  4. 在MCP客户端中配置和使用: 根据上述“服务器配置”部分的内容,在您的MCP客户端(如Claude Desktop)中添加对应的服务器配置,即可发现并使用QuickMCP服务器提供的工具、资源和Prompt。

信息

分类

开发者工具