Skip to main content
hc
Submit
mcpSource-backedReview first Safety ✓ Privacy ✓

Nginx UI MCP Module

Built-in MCP interface for Nginx UI that lets Claude-compatible agents manage Nginx configuration files, inspect Nginx status, reload Nginx, and restart the Nginx service through an authenticated SSE endpoint.

by Nginx UI·added 2026-06-06·
Claude CodeClaude Desktop
HarnessClaude CodeClaude Desktop
Review first — review before installing

Open the source and read safety notes before installing.

Safety notes

  • Nginx UI MCP exposes executable tools for listing, reading, creating, modifying, renaming, enabling, and organizing Nginx configuration files.
  • Service tools can inspect status, reload Nginx, and restart the Nginx service, which can interrupt traffic or apply broken configuration.
  • The MCP endpoint is authenticated through a `node_secret` query parameter; treat it as a secret and rotate it if exposed.
  • Require human review, syntax validation, backups, and deployment windows before enabling configs, reloading, or restarting production Nginx.
  • Limit MCP access to trusted networks and approved clients; do not expose the endpoint publicly without strong transport security and access controls.

Privacy notes

  • Nginx configuration files can reveal domains, upstream services, internal IPs, ports, TLS paths, certificate references, proxy headers, auth settings, rewrite rules, and deployment topology.
  • MCP requests, responses, logs, screenshots, and chat transcripts can retain configuration contents, node secrets, hostnames, service status, and change history.
  • Restart and reload operations can create operational logs that identify users, timestamps, affected sites, and infrastructure state.
  • Redact `node_secret`, private domains, internal addresses, certificate paths, and customer routing details before sharing prompts or PR notes.

Prerequisites

  • Running Nginx UI deployment with the MCP module available.
  • MCP client support for SSE or URL-based remote MCP server configuration.
  • Valid `node_secret` for the target Nginx UI node.
  • Review of which Nginx configuration base path, virtual hosts, enabled sites, and service controls the agent may access.
  • Change-management policy for AI-assisted Nginx edits, reloads, restarts, and production traffic impact.

Schema details

Install type
cli
Troubleshooting
No
Source repository stats
Scope
Source repo
Collection metadata
Estimated setup
20 minutes
Difficulty
intermediate
Tool listing metadata
Disclosure
AGPL-3.0-licensed Nginx UI project with a built-in MCP module. Use it only on Nginx deployments where AI-assisted configuration management and service control are explicitly approved.
Full copyable content
{
  "mcpServers": {
    "nginx-ui": {
      "url": "https://<nginx-ui-host>/mcp?node_secret=<node-secret>"
    }
  }
}

About this resource

Content

Nginx UI MCP Module is the built-in Model Context Protocol interface provided by Nginx UI. It exposes an authenticated /mcp endpoint so Claude-compatible agents can manage Nginx configuration files, inspect Nginx status, reload Nginx, and restart the Nginx service through Nginx UI.

Use it when an operations team wants an MCP interface for Nginx configuration management with explicit review around every write, enable, reload, or restart operation.

Source Review

These sources were reviewed on 2026-06-06. Prefer the live repository, MCP overview, README, license, configuration-management guide, Nginx service guide, router source, tool registration source, config modification source, and restart tool source for current setup and behavior details.

Features

  • Provide an authenticated MCP endpoint at the Nginx UI /mcp path.
  • Authenticate MCP access with the node_secret query parameter.
  • List, read, create, modify, rename, and organize Nginx configuration files.
  • Create configuration directories and inspect configuration history.
  • Enable previously created Nginx configurations.
  • Query Nginx status.
  • Reload Nginx configuration.
  • Restart the Nginx service.

Installation

Deploy Nginx UI and identify the target node secret for the Nginx UI instance you want Claude to access. Then configure an MCP client with the authenticated MCP endpoint for that deployment:

{
  "mcpServers": {
    "nginx-ui": {
      "url": "https://<nginx-ui-host>/mcp?node_secret=<node-secret>"
    }
  }
}

Use the actual scheme, host, path, and secret from the approved Nginx UI deployment. Store node_secret in a secret manager or local MCP config that is not committed to a repository.

Use Cases

  • Ask Claude to inspect available Nginx configuration files before proposing a change.
  • Review a virtual host configuration and identify syntax or routing concerns.
  • Draft a config update, then apply it only after human approval.
  • Enable a staged site configuration with explicit confirmation.
  • Check Nginx status during an incident response workflow.
  • Reload Nginx after a reviewed configuration change.
  • Restart Nginx during a planned maintenance window.

Safety and Privacy

Nginx UI MCP Module can change live web-server behavior. Treat every write, enable, reload, and restart operation as production-impacting unless you know the target node is a sandbox. Require human approval, config validation, backups, and a rollback plan before using the write or service-control tools.

Treat node_secret, Nginx configuration contents, hostnames, internal upstreams, TLS paths, status output, change history, logs, and MCP transcripts as sensitive. Limit endpoint exposure to trusted networks and redact operational details before sharing prompts, screenshots, or validation notes.

Duplicate Check

No 0xJacky/nginx-ui, Nginx UI MCP, Nginx UI MCP Module, Nginx configuration MCP, or matching source URL entry was found in content/mcp or README.md. Existing web-server, DevOps, and browser automation entries do not cover Nginx UI's built-in MCP endpoint for Nginx configuration and service management.

#nginx#devops#configuration#server-management#sse

Source citations

Signals

Loading live community signals…

More like this, weekly

A short, calm digest of reviewed Claude resources. Unsubscribe any time.