mcpField
S
Swagger MCP Server

Swagger MCP Server

本地服务
github.com/marcin-sucharski开发工具019 周前更新
代码仓库

关于 Swagger MCP Server

Swagger MCP Server 将 Swagger/OpenAPI 定义的 API 接入 MCP，面向需要让 AI Agent 调用这些 API 的开发者。它通过配置多个定义 URL 来选择要公开的端点。

主要功能

  1. 01公开 Swagger/OpenAPI API
  2. 02通过 JSON 配置端点
  3. 03支持多个端点

适用场景

  1. 01向 AI Agent 提供 Swagger API
  2. 02配置多个 API 定义供 MCP 使用

MCP 相关

它作为 MCP 服务，将配置中的 Swagger/OpenAPI API 暴露给 MCP 客户端。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "swagger-mcp-server-marcin-sucharski": {
      "command": "npx",
      "args": [
        "-y",
        "swagger-mcp-server"
      ]
    }
  }
}
启动命令npx -y swagger-mcp-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmswagger-mcp-server

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Swagger MCP 服务

一个用于 Swagger/OpenAPI 端点的模型上下文协议服务。此工具可通过模型上下文协议公开 Swagger 定义的 API，使 AI Agent 能够访问这些 API。

安装

你可以全局安装此软件包：

npm install -g swagger-mcp-server

或者直接使用 npx：

npx swagger-mcp-server <config-file>

使用方法

  1. 创建一个配置文件（JSON），定义要公开的 Swagger 端点：
{
  "endpoints": [
    {
      "name": "example-api",
      "url": "https://example.com/api/swagger.json"
    }
  ]
}
  1. 运行服务：
swagger-mcp-server config.json

或者使用 npx：

npx swagger-mcp-server config.json

配置选项

配置文件支持以下选项：

  • endpoints：要公开的 Swagger 端点数组
    • name：端点的唯一标识符
    • url：Swagger/OpenAPI JSON 定义的 URL

开发

构建项目：

npm run build

在本地运行：

npm run run

许可证

ISC

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。