procoders/openapi-mcp-ts repository overview

⁠OpenAPI or Postman to MCP via Typescript

Turn any OpenAPI spec or Postman Collection into an MCP server. Like, instantly.

⁠Quick Start

docker run -p 8080:8080 procoders/openapi-mcp-ts
--spec-url https://petstore3.swagger.io/api/v3/openapi.json⁠
--upstream-url https://petstore3.swagger.io/api/v3⁠

Point Claude Desktop at http://localhost:8080/mcp and you're done.

⁠Features

• OpenAPI 3.0/3.1 - Each endpoint becomes an MCP tool
• Postman Collections - v2.0 and v2.1 supported, auto-detected
• Zero code - Just point at your spec
• Safe by default - DELETE methods disabled unless explicitly enabled
• Auth built-in - API Key, Bearer, Basic
• Tool filtering - Glob patterns to include/exclude operations

⁠Usage

⁠OpenAPI

docker run -p 8080:8080 procoders/openapi-mcp-ts
--spec-url https://api.example.com/openapi.json⁠
--upstream-url https://api.example.com⁠

⁠Postman Collection

docker run -p 8080:8080 procoders/openapi-mcp-ts
--spec-url https://your-collection.json⁠
--upstream-url https://api.example.com⁠

⁠With auth

docker run -p 8080:8080
-e AUTH_TYPE=bearer
-e AUTH_VALUE="your-token"
procoders/openapi-mcp-ts
--spec-url https://api.example.com/openapi.json⁠
--upstream-url https://api.example.com⁠

⁠Links

• GitHub⁠
• MCPize - Hosted MCP servers⁠