AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
MCP verified MIT Self-run

Hugo Mcp Go

mcp-jmrgrav-hugo-mcp-go · by jmrGrav

Native Go MCP server for Hugo content, tools, SRI checks, chunked assets, and Claude-compatible tool metadata.

↗ Repository
— No reviews yet
0 installs
21 views
0.0% view→install

Install

$ agentstack add mcp-jmrgrav-hugo-mcp-go

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/mcp-jmrgrav-hugo-mcp-go)

Reliability & compatibility

✓ Security review passed
0 installs to date
— no reviews yet
○ Archived

Declared compatibility

Claude CodeClaude DesktopCursorWindsurf

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.

How agent discovery & health will work →
Are you the author of Hugo Mcp Go? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

hugo-mcp-go

[](https://go.dev) [](https://github.com/jmrGrav/hugo-mcp-go/releases/latest) [](https://github.com/jmrGrav/hugo-mcp-go/actions/workflows/ci.yml) [](LICENSE)

hugo-mcp-go is the Go implementation of the Hugo MCP backend used behind mcp-runtime-go.

It is operator-controlled, single-tenant, and designed to serve Hugo content tooling with a native HTTP backend while preserving the older stdio path for rollback.

Architecture

Claude / ChatGPT / Gemini / other MCP clients
  -> mcp-runtime-go (OAuth, gateway, public MCP surface)
  -> hugo-mcp-go (native HTTP backend)
  -> Hugo site content, assets, and build pipeline

Rollback paths preserved:
  -> hugo-mcp-shim
  -> legacy Python backend

mcp-runtime-go stays as the public OAuth and connector compatibility layer. hugo-mcp-go provides the backend transport and tool execution.

Tools

Read and chunked content tools:

  • list_pages
  • get_page
  • get_page_chunk
  • list_assets
  • get_asset_chunk

Mutation and operational tools:

  • create_page
  • update_page
  • delete_page
  • upload_asset
  • build_site
  • check_sri_versions
  • generate_featured_image

Transport

  • Native HTTP mode is explicitly enabled with HUGO_MCP_TRANSPORT=http
  • POST /mcp is the compatibility endpoint
  • stdio mode remains available for rollback and local use
  • backend-only streaming events are available on /mcp/events
  • tool catalogs now expose MCP title and tool annotations for classification

Example native backend URL:

  • http://127.0.0.1:18181/mcp

Configuration

Common required roots:

  • HUGO_ROOT
  • HUGO_CONTENT_ROOT
  • HUGO_STATIC_ROOT

Native HTTP settings:

  • HUGO_MCP_TRANSPORT=http|stdio
  • HUGO_MCP_HTTP_BIND_ADDR
  • HUGO_MCP_HTTP_BIND_PORT
  • HUGO_MCP_HTTP_TOKEN_FILE
  • HUGO_MCP_STREAMING_ENABLED
  • HUGO_MCP_MAX_CHUNK_BYTES
  • HUGO_MCP_MAX_RESPONSE_BYTES

Security Model

  • file-backed secrets only
  • no shell execution
  • bounded payload sizes
  • traversal and symlink escape rejection
  • explicit tool annotations for read-only versus destructive actions
  • OAuth remains delegated to mcp-runtime-go

See:

  • [docs/ABOUT.md](docs/ABOUT.md)
  • [SECURITY.md](SECURITY.md)
  • [docs/KNOWN_ISSUES.md](docs/KNOWN_ISSUES.md)

Schema Compatibility

All MCP tool inputSchema and outputSchema fragments are validated in the test suite to ensure they carry an explicit JSON Schema keyword (type, oneOf, anyOf, allOf, $ref, enum, or const). Empty fragments ({}) are rejected by the Claude Code MCP validator; the test TestAllToolSchemasHaveNoEmptyFragments catches any regression of this kind before it reaches production.

Validation

The current release has been validated with:

  • go test ./...
  • go test -race ./...
  • go vet ./...
  • scripts/native-http-smoke.sh

The native backend is live in controlled production, while the shim and Python backend remain preserved for rollback.

License: MIT

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet, be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Security