Overview

openapi-mcp-server

Description:
A proxy server that enables natural language interaction with OpenAPI v3.1 compliant APIs

Category: API Integration & Development Tools

Overview: This server acts as a bridge between Claude Desktop and any API that follows OpenAPI v3.1 specification. Key features include:

• Automatic conversion of API endpoints into Claude-compatible tools
• Support for file uploads via multipart/form-data
• Handles both local and remote server APIs
• File path resolution with security restrictions
• Optimized memory usage for large file handling
• Progress reporting for large uploads

Installation & Configuration:

# Install dependencies
pnpm install

# Build and link
pnpm build
npm link

Configuration Example:

{
  "mcpServers": {
    "petstore-api": {
      "command": "npx",
      "args": ["openapi-mcp-server", "/abs/path/to/petstore-openapi.json"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

Key Features:

• Natural language API interaction
• Interactive API exploration
• Automated parameter handling
• File upload support with security measures
• Response optimization for JSON/text
• Local development testing capabilities

Technical Limitations:

• OpenAPI v3.1 specs only
• Local file support only (no remote URLs)
• No streaming response support yet
• File size limits depend on target API

Note: If experiencing issues with Claude crashes or spec compatibility, use the provided spec cleaner app to optimize OpenAPI schemas for LLM readability.