parse-swagger
Extract API operation details from Swagger/OpenAPI documents. Specify URL, headers, and optional schema or detailed information for streamlined API integration and analysis.
Instructions
Parse Swagger/OpenAPI document and return API operation information.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| headers | No | Request headers | |
| includeDetails | No | Whether to include all details like request bodies, responses, etc. | |
| includeSchemas | No | Whether to include schema definitions | |
| url | Yes | Swagger/OpenAPI document URL |
Implementation Reference
- src/tools/swagger-parser-tool.ts:61-149 (handler)Main handler function that implements the core logic of the 'parse-swagger' tool: fetches Swagger/OpenAPI document, parses operations using OptimizedSwaggerApiParser, optionally includes schemas and full details, handles errors, and returns structured JSON response.async execute({ url, headers = {}, includeSchemas = false, includeDetails = false }: z.infer<typeof this.schema>) { try { console.log(`[SwaggerParserTool] 解析Swagger文档: ${url}`); // 创建解析器实例 const parser = new OptimizedSwaggerApiParser({ url, headers, useCache: true, skipValidation: true }); // 解析API文档 const api = await parser.fetchApi(); // 获取API操作 const operations = await parser.getAllOperations(); // 构建结果对象 const result: any = { success: true, info: { title: api.info.title, version: api.info.version, description: api.info.description }, operationsCount: operations.length, operations: operations.map(op => { // 基本操作信息 const operation = { operationId: op.operationId, method: op.method, path: op.path, summary: op.summary, tags: op.tags }; // 如果需要详细信息，则包含参数和响应 if (includeDetails) { return { ...operation, parameters: op.parameters, requestBody: op.requestBody, responses: op.responses }; } return operation; }) }; // 如果需要模式定义，则添加到结果中 if (includeSchemas) { result.schemas = await parser.getAllSchemas(); } console.log(`[SwaggerParserTool] 解析完成，找到 ${operations.length} 个API操作`); // 返回结果 return { content: [ { type: 'text' as const, text: JSON.stringify(result, null, 2) } ] }; } catch (error) { console.error(`[SwaggerParserTool] 解析失败:`, error); // 返回错误结果 return { content: [ { type: 'text' as const, text: JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }, null, 2) } ] }; } }
- Zod schema defining the input parameters for the 'parse-swagger' tool: url (required), headers, includeSchemas, includeDetails (optional).schema = z.object({ /** * Swagger/OpenAPI document URL */ url: z.string().describe('Swagger/OpenAPI document URL'), /** * Request headers */ headers: z.record(z.string()).optional().describe('Request headers'), /** * Whether to include schema definitions */ includeSchemas: z.boolean().optional().describe('Whether to include schema definitions'), /** * Whether to include all details */ includeDetails: z.boolean().optional().describe('Whether to include all details like request bodies, responses, etc.') });
- src/tools/swagger-parser-tool.ts:47-56 (registration)Class method that registers the 'parse-swagger' tool on the MCP server using server.tool(), providing name, description, schema, and handler wrapping the execute method.register(server: McpServer) { server.tool( this.name, this.description, this.schema.shape, async ({ url, headers = {}, includeSchemas = false, includeDetails = false }) => { return await this.execute({ url, headers, includeSchemas, includeDetails }); } ); }
- src/index.ts:59-59 (registration)Instantiation and registration of SwaggerParserTool in the main MCP server setup in src/index.ts.new SwaggerParserTool().register(server);
- src/mcp-tools-server.ts:71-71 (registration)Instantiation of SwaggerParserTool in the tools array for registration in the MCP tools server.new SwaggerParserTool(),