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文档。
基本使用方法
-
构建配置文件: 从OpenAPI规范生成配置文件:
quickmcp build config --spec-url https://petstore.swagger.io/v2/swagger.json --output-path ./petstore_mcp这会在 './petstore_mcp' 目录下生成 'petstore_mcp_config.json' 文件以及API规范文件。
-
安装服务器配置(可选,方便CLI启动): 将生成的配置文件安装到本地QuickMCP配置目录:
quickmcp add server ./petstore_mcp/petstore_mcp_config.json -n PetstoreAPI'-n PetstoreAPI' 指定了服务器的别名/ID为 'petstoreapi'。
-
启动MCP服务器: 使用安装的服务器配置启动:
quickmcp serve -i petstoreapi或直接使用配置文件启动:
quickmcp serve -c ./petstore_mcp/petstore_mcp_config.json服务器将通过STDIO协议启动(默认),等待MCP客户端连接并发送JSON-RPC请求。您也可以指定 '--host-protocol http' 来启动HTTP服务器。
-
在MCP客户端中配置和使用: 根据上述“服务器配置”部分的内容,在您的MCP客户端(如Claude Desktop)中添加对应的服务器配置,即可发现并使用QuickMCP服务器提供的工具、资源和Prompt。
信息
分类
开发者工具