Swaggertools MCP

MCP开发工具

提供方 KrystalQAQ

开发工具 未标注 无需鉴权 社区 / 第三方

用于加载和查询OpenAPI/Swagger文档的服务器,支持模糊操作匹配和不完整路径或关键词查询。

一句话选型结论

按资料字段整理

Swaggertools MCP 属于开发工具类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 8 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量8暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

OpenAPITypeScript本地部署SwaggerAPI文档模糊查询开发工具

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 8 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 8 个工具,职责相对集中,接入后不容易误操作。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Swaggertools MCP当前 8 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方KrystalQAQ上游标注的维护方 KrystalQAQ
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

2.1 KB
来自项目仓库与上游目录的原文,未做删改

马大伟

英语| 中文

MCP服务器,用于加载和查询OpenAPI/Swagger文档。
当用户提供不完整的路径或关键字时,它支持模糊操作匹配。

特性

  • 加载远程OpenAPI 3.x文档(JSON/YAML)
  • 带TTL的内存文档缓存
  • 按方法/标签/关键字列出/过滤操作
  • 部分路径的模糊解析操作
  • 检查完整的请求/响应详细信息
  • 检查 components.schemas 以及它们在哪里使用

工具

  • openapi.load
  • openapi.health
  • openapi.reload
  • openapi.list_operations
  • openapi.resolve_operation
  • openapi.get_operation
  • openapi.explain_operation
  • openapi.get_schema

openapi.explain_operation 是为“如何调用此API”答案而设计的,包括参数组、请求示例和响应示例。

令牌保存默认值:

  • openapi.resolve_operation: topK 默认为 3
  • openapi.get_operation:默认为 resolveRefs=false 和 responseFormat=compact
  • openapi.explain_operation:默认为 resolveRefs=false 和 detailLevel=brief

需求

  • Node.js 18+
  • pnpm 10+

快速开始```bash

pnpm install
pnpm dev


构建并运行:```bash
pnpm build
pnpm start

Codex MCP配置示例```json

{
"mcpServers": {
"swagger-mcp": {
"command": "npx",
"args": ["-y", "swaggertools-mcp", "--docPath", "http://dev.manage.zw.uav.sczlcq.com/v3/api-docs"]
}
}
}
```

如果您正在本地积极开发此仓库,您仍然可以使用 pnpm dev.

参数

  • openapi.load 支持运行时输入: url, headers, forceRefresh
  • url (或启动 --docPath 回退)必须是 http/https OpenAPI文档URL
  • 初创公司 --docPath 是可选的,在以下情况下充当默认源 openapi.load.url 未提供
  • 没有从加载默认的OpenAPI URL .env 或其他环境源

docId: "default" 行为

  • 如果文档已经被加载, default 映射到最新加载的 docId.
  • 若还没有加载文档,服务器将返回错误并要求调用 openapi.load 第一。

故障排除

  • 错误: Document not found: default
  • 呼叫 openapi.load 第一。
  • 确保MCP启动参数包括 --docPath.

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Swaggertools MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Swaggertools MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Swaggertools MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Swaggertools MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Swaggertools MCP 能提供哪些能力?

资料显示约 8 个工具;能力标签包括 API集成、开发工具、TypeScript、API文档。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。