swagger-json-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DOCS_DIR | No | Custom docs directory | ./custom-docs |
| LOG_LEVEL | No | Set log level | info |
| MAX_SCHEMA_DEPTH | No | Maximum schema resolution depth | 10 |
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 | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_swaggersA | 列出所有可用的 Swagger 檔案 |
| get_swagger_overviewB | 獲取 Swagger 檔案的整體概覽和統計資訊 |
| get_schemaB | 獲取指定 schema 的完整定義，自動解析所有 $ref 引用 |
| get_api_infoA | 獲取特定 API 的完整資訊，自動解析所有相關 schemas |
| search_apisA | 搜索 API endpoints，支援模糊搜索和多種過濾條件 |
| search_schemasA | 搜索 schema 定義，支援模糊搜索和類型過濾 |
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 6 tools
Each tool targets a distinct resource and action: listing swaggers, getting overviews, retrieving schemas, retrieving API info, and searching APIs or schemas. No overlap in purpose; agents can easily select the right tool.
All tool names follow a consistent verb_noun pattern using snake_case (list_*, get_*, search_*). The nouns are clear and descriptive, with only minor pluralization inconsistencies that do not affect predictability.
Six tools is well-scoped for a Swagger/OpenAPI inspection server. Each tool covers a distinct aspect of reading and exploring API definitions without being excessive or minimal.
The tool surface provides a complete read-only workflow: list available Swagger files, get overview statistics, retrieve detailed schema definitions with $ref resolution, get full API info, and search for APIs/schemas. No obvious gaps for a browsing/inspection use case.