OpenAPI MCP Server with mcp-proxy

This setup runs the OpenAPI MCP Server (https://github.com/snaggle-ai/openapi-mcp-server) in Docker with mcp-proxy (https://github.com/sparfenyuk/mcp-proxy) to expose the MCP server over HTTP/SSE.

Setup

1. Run the setup script to copy the OpenAPI definition:

chmod +x setup.sh
./setup.sh

2. Set your API token as an environment variable:

export OPENAPI_TOKEN=your_token_here

3. Build and start the Docker container:

docker-compose up --build

Usage

Once running, the MCP server is available at:

http://localhost:8080/sse

The server will use the token from the OPENAPI_TOKEN environment variable as the Bearer token for API requests.

Configuration

• The OpenAPI definition is mounted from ./teable-openapi.json to /app/teable-openapi.json in the container
• The server listens on port 8080
• Authorization headers are set using the OPENAPI_TOKEN environment variable

Architecture

Client ⟷ HTTP/SSE ⟷ mcp-proxy ⟷ stdio ⟷ openapi-mcp-server

The mcp-proxy converts between HTTP/SSE and stdio protocols, allowing the openapi-mcp-server (which only supports stdio) to be accessible over HTTP.