ai.com.mcp/hapi-mcp

Official

HAPI MCP Server

HAPI MCP server: Dynamically exposes OpenAPI REST APIs as MCP tools for AI assistants

Exposes OpenAPI REST APIs as MCP tools for AI assistants to dynamically interact with.

Install

Configuration

Environment variables

HAPI_FQDNdefault localhost

Fully Qualified Domain Name for the HAPI server (used in MCP tool URLs)

HAPI_HOMEdefault /app/.hapi

Directory path for HAPI configuration and specs. Should be mounted as a volume in Docker

PROJECT_NAME

The name of the project/API (alternative to positional argument)

HAPI_OPENAPI

OpenAPI spec URL or path (alternative to --openapi flag)

HAPI_URL

Backend API base URL (alternative to --url flag)

HAPI_PORTdefault 3030

Server port (alternative to --port flag) - this is the internal container port

HAPI_HEADLESSdefault true

Enable headless mode (alternative to --headless flag)

HAPI_MCPdefault true

Enable MCP mode (alternative to --mcp flag)

HAPI_DEV

Enable development mode (alternative to --dev flag)

HAPI_CORS

Comma-separated allowed CORS origins (alternative to --cors flag)

HAPI_CONFIG_FILES

Comma-separated configuration files (alternative to --filename flag)

NODE_ENVdefault production

Node environment (development, production). 'development' enables verbose logging and debugging features.

Arguments

-prequireddefault 3030:3030

port

-vdefault ~/.hapi:/app/.hapi

volume

serverequireddefault serve

projectName

petstore

--portdefault 3030

port

--headlessdefault true

--mcpdefault true

--dev

--url

url

--openapi

openapi

--cors

origins

--filename

files

--cert

path

--key

path

claude_desktop_config.json

{
  "mcpServers": {
    "hapi-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/hapimcp/hapi-cli:0.6.0",
        "serve",
        "<YOUR_PROJECTNAME>",
        "--port",
        "3030",
        "--headless",
        "true",
        "--mcp",
        "true",
        "--dev",
        "--url",
        "--openapi",
        "--cors",
        "--filename",
        "--cert",
        "--key"
      ],
      "env": {
        "HAPI_FQDN": "localhost",
        "HAPI_HOME": "/app/.hapi",
        "PROJECT_NAME": "<YOUR_PROJECT_NAME>",
        "HAPI_OPENAPI": "<YOUR_HAPI_OPENAPI>",
        "HAPI_URL": "<YOUR_HAPI_URL>",
        "HAPI_PORT": "3030",
        "HAPI_HEADLESS": "true",
        "HAPI_MCP": "true",
        "HAPI_DEV": "<YOUR_HAPI_DEV>",
        "HAPI_CORS": "<YOUR_HAPI_CORS>",
        "HAPI_CONFIG_FILES": "<YOUR_HAPI_CONFIG_FILES>",
        "NODE_ENV": "production"
      }
    }
  }
}