Provides tools to query and retrieve JSON schemas for API requests and responses from Swagger/OpenAPI specifications, including support for path parameters and automatic reference resolution.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-swagger-schemaget the schema for the /api/v1/users endpoint"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-swagger-schema
一个 MCP (Model Context Protocol) 服务器，用于查询 Swagger 规范中的接口 schema。
功能
根据 API 路径获取请求和响应的 JSON Schema
自动解析
$ref引用支持路径参数匹配（如
/api/users/{id}）内置缓存机制
快速开始
第一步：找到你的 Swagger JSON 地址
你需要先获取项目的 Swagger/OpenAPI 规范地址，通常是类似这样的 URL：
https://your-api.com/v3/api-docs
第二步：配置 MCP 服务器
在你的 MCP 配置文件中（通常是 .mcp/config.json 或类似的配置），添加如下配置：
{
"mcpServers": {
"swagger-schema": {
"command": "npx",
"args": ["-y", "mcp-swagger-schema"],
"env": {
"SWAGGER_SPEC_URL": "替换成你的swagger地址"
}
}
}
}⚠️ 常见问题：找不到 npx 命令
如果启动失败，提示找不到 npx，按以下步骤解决：
步骤 1：打开终端，运行以下命令
which npx你会看到类似这样的输出：
/Users/你的用户名/.nvm/versions/node/v20.0.0/bin/npx步骤 2：复制 bin 目录路径
把上面输出的路径，去掉最后的 /npx，得到 bin 目录：
/Users/你的用户名/.nvm/versions/node/v20.0.0/bin步骤 3：修改配置，添加 PATH
{
"mcpServers": {
"swagger-schema": {
"command": "npx",
"args": ["-y", "mcp-swagger-schema"],
"env": {
"SWAGGER_SPEC_URL": "替换成你的swagger地址",
"PATH": "步骤2得到的路径:/usr/bin:/bin"
}
}
}
}例如：
{
"mcpServers": {
"swagger-schema": {
"command": "npx",
"args": ["-y", "mcp-swagger-schema"],
"env": {
"SWAGGER_SPEC_URL": "https://api.example.com/swagger.json",
"PATH": "/Users/zhangsan/.nvm/versions/node/v20.0.0/bin:/usr/bin:/bin"
}
}
}
}使用方法
配置完成后，在对话中直接说：
获取 /api/users 接口的 schema
AI 会调用工具返回该接口的请求参数和响应结构。
工具参数说明
参数 | 必填 | 说明 |
| ✅ | 接口路径，如 |
| ❌ | HTTP 方法（get/post/put/delete），不填会自动选择 |
返回示例
{
"found": true,
"path": "/api/users",
"method": "post",
"summary": "创建用户",
"request": {
"body": {
"type": "object",
"properties": {
"name": { "type": "string" },
"email": { "type": "string" }
}
}
},
"response": {
"type": "object",
"properties": {
"id": { "type": "integer" },
"name": { "type": "string" }
}
}
}环境变量
变量名 | 必填 | 说明 |
| ✅ | Swagger/OpenAPI JSON 规范的 URL |
| ❌ | 缓存过期时间（毫秒），默认 60000 |
License
MIT
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.