swagger-mcp-tools
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SWAGGER_URL | Yes | The URL of the Swagger/OpenAPI documentation endpoint. | |
| SWAGGER_TOKEN | No | Optional API token for authentication. | |
| SWAGGER_MCP_PROJECT_ROOT | No | Optional environment variable to specify the project root directory for config file discovery. Can be '$CWD', '$PWD', an absolute path, or a relative path. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| getModulesB | 获取 Swagger API 的所有模块列表 |
| getApisB | 获取指定模块下的所有接口列表 |
| getApiB | 获取指定接口的参数和返回值类型信息 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 3 tools
每个工具对应一个明确的层级：模块列表、接口列表、接口详情，目的清晰且互不重叠。代理可以准确区分三个工具的使用场景。
三个工具均使用 get + 名词的驼峰命名模式（getModules, getApis, getApi），单复数使用合理，命名风格完全统一。
3个工具正好覆盖Swagger浏览的核心层级（模块→接口→详情），没有冗余也没有明显缺失，数量与目的匹配。
浏览流程覆盖完整，能够通过模块->接口->详情链路获取所需信息；但缺少全局接口搜索或直接查看原始Swagger定义的能力，略有小缺口。