mcp-swagger-schema
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.
Tools
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/izjing/mcp-swagger'
If you have feedback or need assistance with the MCP directory API, please join our Discord server