HAPI MCP Server

Official

by mcp

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

ai.com.mcp/hapi-mcp — HAPI MCP Server

The ai.com.mcp/hapi-mcp server (“HAPI MCP server: Dynamically exposes OpenAPI REST APIs as MCP tools for AI assistants”) provides an MCP interface that surfaces OpenAPI-based REST APIs as callable MCP tools, enabling AI assistants to access those API endpoints through MCP.

🛠️ Key Features

Dynamically exposes OpenAPI REST APIs as MCP tools for AI assistants

🚀 Use Cases

Use MCP tools to interact with REST APIs described by OpenAPI specifications

⚡ Developer Benefits

Provides a tool-based bridge from OpenAPI REST APIs to AI assistant workflows via MCP

⚠️ Limitations

No additional tool count, topics, or detailed capabilities were provided in the source data

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

Add to VS Code Add to Cursor

claude_desktop_config.json

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"
      }
    }
  }
}