Skip to main content
Glama
maohuihua123

swagger-mcp-server

by maohuihua123
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

swagger-mcp-server

Swagger-MCP-Server 基于 Swagger 文档作为接口约束标准，允许用户通过自然语言方式与大模型（如 ChatGPT）对话，触发网站接口调用，完成数据的查询、分析和处理，具备即席分析、实时反馈等特点，为用户提供了全新的体验。

1.使用配置

1.1.安装Cherry Studio

官网网站：https://cherry-ai.com/

1.2.拉取项目

https://github.com/maohuihua123/swagger-mcp-server.git

1.3.配置MCP-Server

NOTE

路径修改为自己的本地项目路径：例如c:/Users/Administrator/Desktop/swagger-mcp-server

Swagger文件链接需要可访问：例如http://localhost:8080/v3/api-docs/openapi.json

{
  "mcpServers": {
    "ct8e9lwgcZCYAp_c5UErc": {
      "name": "swagger-mcp",
      "type": "stdio",
      "isActive": true,
      "registryUrl": "",
      "command": "uv",
      "args": [
        "--directory",
        "c:/Users/Administrator/Desktop/swagger-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "OPEN_API_URL": "http://localhost:8080/v3/api-docs/openapi.json"
      }
    }
  }
}

Related MCP server: mcp-swagger

2.使用案例

2.1.查看接口列表

告诉我网站有哪些功能？ 告诉我有哪些功能接口？

2.2.调用具体接口

TIP

在输入指令时，让大模型先调用接口详细工具，从而获得准确的接口URL、接口参数等，再发起调用

调用创建用户接口，创建新用户，用户名为张三，邮箱为123456@qq.com；在调用之前，先查询接口详细信息

2.3.生成接口测试计划

你是一位资深软件测试工程师，结合网站的接口文档，请基于等价类划分、边界值分析等测试设计方法，自动生成测试计划、测试用例。

2.4.自动化接口测试

基于制定的测试计划，对网站接口进行自动化测试调用，并输出最终测试报告。

3.想法来源

TIP

MCP协议解决的是大模型无法随意调用服务的问题，如果能通过清晰的接口定义，让大模型可以自己构造参数调用服务，是否可以减少MCP-Server的开发？

  • 基于 Swagger 文档作为约束标准，能够快速适配不同的网站和服务，无需为每个网站单独开发集成逻辑。

  • 通过接口调用获取数据后，结合大模型的分析能力，快速生成数据洞察、图表或预测结果，实现即席分析。

  • 基于大模型的自然语言交互界面，未来是否能够作为传统UI界面的补充，从而为用户提供了新的体验？

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • swaggbot

    TechBloom-ai
    A
    license
    Not graded
    quality
    D
    maintenance
    Transforms Swagger/OpenAPI documented APIs into conversational interfaces, enabling natural language interaction with APIs through an MCP server for use with AI assistants.
    4
    MIT

  • mcp-swagger

    awssam
    A
    license
    A
    quality
    D
    maintenance
    Exposes Swagger/OpenAPI API documentation to AI models, enabling exploration, search, and interaction with endpoints, schemas, and execution of API calls.
    14
    1 npm
    2
    MIT

  • swagger-mcp

    yunhwane
    A
    license
    B
    quality
    D
    maintenance
    Enables natural language exploration of OpenAPI/Swagger specs, allowing users to register APIs, browse endpoints, describe schemas, and detect breaking changes through conversational queries.
    9
    177 npm
    MIT

  • mcp-openapi

    avidianity
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI agents to discover, search, and call any REST API described by an OpenAPI or Swagger document. Supports multiple API endpoints with authentication and parameter handling.
    6 npm
    MIT