AI导哈

Swagger MCP服务器

Swagger-MCP-server是一个轻量级的模型上下文协议（MCP）服务器，通过OpenAPI 3.0规范与Swagger Petstore API交互，动态加载API工具并暴露端点。

  • by abhishek-iiit
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 abhishek-iiit/swagger-mcp-server

使用说明

Swagger MCP服务器

Swagger MCP服务器 是一个轻量级的模型上下文协议（MCP）服务器，与 Swagger Petstore API 的 使用OpenAPI 3.0规范。服务器动态加载中定义的API工具 openapi.json 并使用 mcp.server.fastmcp 模块。

📦 特性

  • ✅ OpenAPI 3.0规范（Petstore）的动态加载。
  • 🐾 全面支持宠物店运营：宠物、商店、用户。
  • ⚡ 使用FastAPI构建。
  • 🛠️ 利用 mcp 服务器CLI和动态工具注册。

🚀 安装指南

  1. 克隆存储库
git clone https://github.com/abhishek-iiit/Swagger-MCP-server.git
cd Swagger-MCP-server
  1. 创建并激活虚拟环境
python3 -m venv .venv
source .venv/bin/activate
  1. 安装依赖项
pip install -r requirements.txt

🧪 运行服务器

要启动服务器，请执行以下操作：

python main.py

这将启动一个MCP服务器，该服务器注册openapi.json文件中定义的端点，并通过Petstore API接口为其提供服务。

📚 API终点

服务器镜像Swagger Petstore API。它包括以下操作：

宠物

  • 添加新宠物
  • 更新现有宠物
  • 按状态或标签查找宠物
  • 通过ID获取宠物
  • 删除宠物
  • 商店
  • 下订单
  • 按ID获取订单
  • 检查库存
  • 用户
  • 创建用户
  • 登录/登出
  • 按用户名获取用户
  • 更新/删除用户

📦 依赖项

依赖关系列在requirements.txt中，包括：

  • fastapi：高性能API框架。
  • httpx：异步兼容的HTTP客户端。
  • mcp[cli]：模型上下文协议服务器框架。
  • jsonschema: JSON Schema 验证。

通过以下方式安装它们：

pip install -r requirements.txt

相关 MCP