{{ message }}

gulbaki / swagger-mcp-server Public

• Notifications
• Fork2
• Star 13

13 stars2 forksBranches Tags Activity

Star

Notifications

main

BranchesTags

Go to file

Code

Name	Name	Last commit message	Last commit date
3 Commits
src	src
.gitignore	.gitignore
package-lock.json	package-lock.json
package.json	package.json
readme.md	readme.md
tsconfig.json	tsconfig.json
View all files

Repository files navigation

Swagger/OpenAPI MCP Server

A Model Context Protocol (MCP) server that allows LLMs to explore and interact with Swagger/OpenAPI specifications. This server provides tools and resources for loading API specifications, browsing endpoints, and getting detailed information about API operations.

Installation

1. Clone or create the project directory
2. Install dependencies:

npm install

1. Build the TypeScript code:

npm run build

Usage

Available Tools

load_api

Load an OpenAPI/Swagger specification into the server.

Parameters:

• apiId (string): Unique identifier for this API
• source (string): URL or file path to the OpenAPI/Swagger specification

Example:

{ "name": "load_api", "arguments": { "apiId": "petstore", "source": "https://petstore.swagger.io/v2/swagger.json" } }

get_endpoint_details

Get detailed information about a specific API endpoint.

Parameters:

• apiId (string): ID of the loaded API
• method (string): HTTP method (GET, POST, etc.)
• path (string): API endpoint path
• natural (boolean, optional): If true, returns a human-readable summary

Example:

{ "name": "get_endpoint_details", "arguments": { "apiId": "petstore", "method": "GET", "path": "/pet/{petId}", "natural": true } }

list_apis

List all currently loaded API specifications.

Parameters: None

search_endpoints

Search for endpoints matching a specific pattern.

Parameters:

• apiId (string): ID of the loaded API
• pattern (string): Search pattern for endpoint paths or descriptions

Example:

{ "name": "search_endpoints", "arguments": { "apiId": "petstore", "pattern": "pet" } }

Available Resources

swagger://{apiId}/load

Get overview information about a loaded API specification.

swagger://{apiId}/endpoints

Get a list of all available endpoints for an API.

swagger://{apiId}/endpoint/{method}/{path}

Get detailed information about a specific endpoint.

Configuration with Claude Desktop

To use this server with Claude Desktop, add the following to your claude_desktop_config.json:

{ "mcpServers": { "swagger-explorer": { "command": "node", "args": ["/path/to/your/swagger-mcp-server/build/index.js"] } } }

Replace /path/to/your/swagger-mcp-server with the actual path to your project directory.

License

MIT License

About

No description, website, or topics provided.

Readme

Activity

13 stars

0 watching

2 forks

Report repository

Releases

No releases published

Packages

No packages published

Languages

• TypeScript 100.0%