hugo-mcp-server

hugo-mcp-server

Enables managing Hugo static site content via the MCP protocol, including schema and record CRUD, markdown generation, build, and publish.

Category
Visit Server

README

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:

Variable Default
PORT 3100
HUGO_API_BASE_URL http://host.docker.internal:8080
MCP_API_KEY (empty — auth disabled)

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

Tool Purpose
health Upstream API health
list_schemas / get_schema / upsert_schema / delete_schema / import_schema Schema CRUD
list_records / get_record / create_record / list_registry Page records
generate_page / generate_from_records Write Hugo markdown
build_site Run Hugo CLI
publish_site Sync public/ to R2 via publisher
list_themes / get_theme / get_selected_theme / import_theme / select_theme / delete_theme Theme library
scan_theme_signals / suggest_theme_schemas / apply_theme_schemas Theme → schema helpers

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

Variable Required Description
HUGO_API_BASE_URL yes Hugo Generator API base URL (no trailing slash)
PORT no Listen port (default 3100)
MCP_API_KEY no When set, /mcp requires Authorization: Bearer <key>

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

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured