OpenAPI MCP Server

Overview

• This project will install MCP - Model Context Protocol Server, that provides configured REST API's as context to LLM's.

• Using this we can enable LLMs to interact with RestAPI's and perform REST API call's using LLM prompts.

• Currently we support HTTP API Call's GET/PUT/POST/PATCH.

Installation

• Install package

  pip install openapi_mcp_server

• Create .env in a folder with minimum values for OPENAPI_SPEC_PATH & API_BASE_URL. Sample file available here

• Test openapi_mcp_server server using uv run openapi_mcp_server from the above folder.

Claud Desktop

• Configuration details for Claud Desktop

  { "mcpServers": { "openapi_mcp_server":{ "command": "uv", "args": ["run","openapi_mcp_server"] "env": { "DEBUG":"1", "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" } } } }

  

Configuration

• List of available environment variables

  • DEBUG: Enable debug logging (optional default is False)

  • OPENAPI_SPEC_PATH: Path to the OpenAPI document. (required)

  • API_BASE_URL: Base URL for the API requests. (required)

  • 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 (optional)

  • HTTPS_PROXY: HTTPS Proxy details (optional)

  • NO_PROXY: No Proxy details (optional)

Contributing

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

License

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

Github Stars

Appendix

UV

Reference

• UV Overview