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-schema get 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 (Model Context Protocol) 服务器，用于查询 Swagger 规范中的接口 schema。
根据 API 路径获取请求和响应的 JSON Schema
自动解析 $ref 引用
支持路径参数匹配（如 /api/users/{id}）
内置缓存机制
Related MCP server: swagger-json-mcp
你需要先获取项目的 Swagger/OpenAPI 规范地址，通常是类似这样的 URL：
https://your-api.com/v3/api-docs
在你的 MCP 配置文件中（通常是 .mcp/config.json 或类似的配置），添加如下配置：
{
"mcpServers": {
"swagger-schema": {
"command": "npx",
"args": ["-y", "mcp-swagger-schema"],
"env": {
"SWAGGER_SPEC_URL": "替换成你的swagger地址"
}
}
}
}如果启动失败，提示找不到 npx，按以下步骤解决：
which npx你会看到类似这样的输出：
/Users/你的用户名/.nvm/versions/node/v20.0.0/bin/npx把上面输出的路径，去掉最后的 /npx，得到 bin 目录：
/Users/你的用户名/.nvm/versions/node/v20.0.0/bin{
"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 |
MIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
MCP server for AI access to SmartBear tools, including BugSnag, Reflect, Swagger, PactFlow, QTM4J.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
MCP server providing access to the Scorecard API to evaluate and optimize LLM systems.
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