Hugo MCP Remote Server

Streamable HTTP MCP server that wraps the Hugo Generator API. Use it from Cursor (or any MCP remote client) to add and manage page schemas, records, generate markdown, build, and publish.

Prerequisites

• Node.js 22+

• A running Hugo Generator API (HUGO_API_BASE_URL)

Local development

cp .env.example .env
# edit HUGO_API_BASE_URL if needed

npm install
npm run dev

Server listens on http://localhost:3100/mcp by default.

npm run build && npm start

Docker

docker compose up --build -d

Defaults:

extra_hosts: host.docker.internal:host-gateway lets the container reach an API on the host machine. If the API runs in the same Compose network, set HUGO_API_BASE_URL to that service URL instead (e.g. http://hugo-generator:8080).

Cursor MCP config

Add a remote server entry (path may vary by Cursor version):

{
  "mcpServers": {
    "hugo": {
      "url": "http://localhost:3100/mcp"
    }
  }
}

With optional bearer auth (MCP_API_KEY set on the server):

{
  "mcpServers": {
    "hugo": {
      "url": "http://localhost:3100/mcp",
      "headers": {
        "Authorization": "Bearer change-me"
      }
    }
  }
}

Tools

Typical content workflow: list_schemas → create_record → generate_from_records → build_site → publish_site.

Note: The upstream Records API supports create/list/get only (no update/delete).

Environment

GET /health on this server is always unauthenticated (for Docker healthchecks).