openapi-mcp-server 0.1.0

MCP Server For OpenAPI

OpenAPI MCP Server 🎭

A Model Context Protocol server that provides REST API automation.
This server enable LLMs to interact with RestAPI's.
It takes swagger as input.
Support all HTTP API Call's GET/PUT/POST/PATCH

Installation

• Install package

  pip install openapi_mcp_server
  

• Below is an example to test Petstore, details available here

  DEBUG="True"
  API_BASE_URL="https://petstore.swagger.io/v2"
  OPENAPI_SPEC_PATH="https://petstore.swagger.io/v2/swagger.json"
  API_HEADERS="Accept:application/json"
  API_WHITE_LIST="addPet,updatePet,findPetsByStatus"
  

• Test with above using uv run -m openapi_mcp_server
• Update Claud Desktop configuration with below

  {
    "mcpServers": {
      "openapi_mcp_server":{
        "command": "uv",
        "args": [
            "--directory",
            "D:\\mcp\\openapi_mcp_server",
            "run",
            "-m",
            "openapi_mcp_server"
        ],
        "env": {
            "DEBUG":"1",
            "API_BASE_URL":"https://petstore.swagger.io/v2",
            "OPENAPI_SPEC_PATH":"D:\\mcp\\swagger\\petstore.json",
            "API_HEADERS":"Accept:application/json",
            "API_WHITE_LIST":"addPet,updatePet,findPetsByStatus"
        }
      }
    }
  }
  

Features

• FastAPI implementation of MCP
• RESTful API endpoints
• Schema validation

Configuration

• List of available parameters
  • DEBUG: Enable debug logging (optional default is False)
  • OPENAPI_SPEC_PATH: Path to the OpenAPI document
  • API_BASE_URL: Base URL for the API requests
  • API_HEADERS: Headers to include in the API requests (optional)
  • API_WHITE_LIST: White Listed operationId in list format ["operationId1", "operationId2"] (optional)
  • API_BLACK_LIST: Black Listed operationId in list format ["operationId3", "operationId4"] (optional)
  • HTTP_PROXY: HTTP Proxy details
  • HTTPS_PROXY: HTTPS Proxy details
  • NO_PROXY: No Proxy details
• Demo
  • 
  • 

Contributing

Contributions are welcome. Please feel free to submit a Pull Request.

License

This project is licensed under the terms of the MIT license.

Star History