hugo

The Hugo MCP Server is a Model Control Protocol service that manages Hugo static site projects. It exposes a suite of tools to check dependencies, install missing tooling, create and manage Hugo sites, handle themes, and manage content and previews. You can interact with these tools through an MCP client to perform tasks like verifying Hugo installation, installing Hugo or Go, creating new sites, listing and inspecting themes, and performing common site-management actions. This server is Python-based and is intended to be run with uv, delegating tool execution and orchestration to the MCP framework.

To use it, ensure the Hugo MCP server is enabled in your MCP configuration (as shown in the installation section), start the uv-driven service, and connect with an MCP client. Once connected, you can invoke tools such as check_hugo_installation, install_hugo, create_site, list_themes, and get_theme_details to automate Hugo workflows end-to-end.

Prerequisites:

• Python 3.10+
• uv (Python package manager) installed
• Git (recommended)

Installation steps:

1. Clone the repository: git clone https://github.com/sunnycloudyang/hugo-mcp.git

2. Add the Hugo MCP server to your MCP configuration (ensure uv is installed): { "mcpServers": { "hugo-mcp": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/PARENT/FOLDER/hugo-mcp", "run", "main.py" ] } } } Replace "/ABSOLUTE/PATH/TO/PARENT/FOLDER/hugo-mcp" with your actual installation path.

3. Start the MCP server by enabling it in your MCP runtime and launching uv as configured (the example uses uv run main.py).

4. Optional: Start the server manually if needed: uv run main.py

Prerequisites note:

• Hugo is required for many tools; you may need to install Hugo via install_hugo (or follow your OS package manager).
• If you plan to use the site creation and theme tooling, ensure Hugo and Git are properly configured on your system.

Tips and common notes:

• Ensure the installation path in the configuration is correct and accessible by the MCP runtime.
• The environment assumes uv is available; if you encounter PATH issues, verify that uv and Python are correctly installed and in PATH.
• For theme and content related tooling, Hugo must be installed on the host system; use check_hugo_installation to verify before attempting theme operations.
• Network access is required for listing themes from the official Hugo themes source; ensure internet connectivity.
• If a tool returns a failure, inspect the standard error message in the tool response to guide installation or configuration adjustments (e.g., missing Hugo, Git, or package managers).
• The provided npm_package field is null since this MCP server is Python-based and invoked via uv; no npm usage is required.