warnyin ffe0efa311 feat: initial MCP server for Nginx Proxy Manager full API
Implements an MCP stdio server exposing 69 tools that cover every
endpoint of the latest Nginx Proxy Manager swagger spec:

- system (root, version-check, schema, low-level npm_request escape hatch)
- tokens (login, refresh, 2FA validate)
- users (CRUD, auth, permissions, sudo-login, full 2FA lifecycle)
- proxy / redirection / dead / stream hosts (CRUD + enable/disable)
- certificates (CRUD, download, renew, upload, validate, test-http, dns-providers)
- access-lists (CRUD with clients + items)
- audit-log (list, get)
- reports (hosts)
- settings (list, get, update)

Auth: accepts NPM_TOKEN or auto-issues + refreshes a JWT from
NPM_EMAIL/NPM_PASSWORD against NPM_BASE_URL.

Distribution: npx-runnable via the @warnyin/nginx-proxy-manager-mcp
scoped package; bin -> dist/index.js. Build with tsc, no runtime deps
besides @modelcontextprotocol/sdk and zod.
2026-05-22 21:57:43 +07:00

@warnyin/nginx-proxy-manager-mcp

An MCP server that exposes the full Nginx Proxy Manager REST API as tools your AI assistant can call. Drop it into Claude Desktop, Claude Code, Cursor, or any MCP-compatible client and manage proxy hosts, redirections, 404 hosts, streams, SSL certificates, access lists, users, settings, audit log, and reports through natural language.

Tool surface is generated from the latest NPM swagger spec — every documented endpoint is reachable, plus an npm_request low-level escape hatch for anything obscure.

Install / Run

No global install needed. Run via npx:

npx -y @warnyin/nginx-proxy-manager-mcp

The server talks MCP over stdio — point your client at the command above with the env vars described below.

Configuration

Env var Required Default Description
NPM_BASE_URL no http://127.0.0.1:81/api Base URL of NPM API (include /api).
NPM_EMAIL one of – Login email. Combine with NPM_PASSWORD for automatic token issuing + refresh.
NPM_PASSWORD one of – Login password.
NPM_TOKEN one of – Pre-issued JWT. Skips automatic login (will not auto-refresh once expired).

You must provide either NPM_TOKEN or the NPM_EMAIL + NPM_PASSWORD pair.

Claude Desktop / Claude Code config

{
  "mcpServers": {
    "nginx-proxy-manager": {
      "command": "npx",
      "args": ["-y", "@warnyin/nginx-proxy-manager-mcp"],
      "env": {
        "NPM_BASE_URL": "http://127.0.0.1:81/api",
        "NPM_EMAIL": "admin@example.com",
        "NPM_PASSWORD": "changeme"
      }
    }
  }
}

Available tools

Grouped by NPM tag — names use the <group>_<action> convention.

System

  • npm_api_root — GET /
  • npm_version_check — GET /version/check
  • npm_schema — GET /schema
  • npm_request — generic escape hatch for any path / method

Tokens

  • tokens_login, tokens_refresh, tokens_validate_2fa

Users

  • users_list, users_create, users_get, users_update, users_delete
  • users_set_auth, users_set_permissions, users_sudo_login
  • users_2fa_get, users_2fa_setup, users_2fa_enable, users_2fa_disable, users_2fa_backup_codes

Proxy hosts

  • proxy_hosts_list, proxy_hosts_create, proxy_hosts_get, proxy_hosts_update, proxy_hosts_delete
  • proxy_hosts_enable, proxy_hosts_disable

Redirection hosts

  • redirection_hosts_list, redirection_hosts_create, redirection_hosts_get, redirection_hosts_update, redirection_hosts_delete
  • redirection_hosts_enable, redirection_hosts_disable

404 hosts (dead hosts)

  • dead_hosts_list, dead_hosts_create, dead_hosts_get, dead_hosts_update, dead_hosts_delete
  • dead_hosts_enable, dead_hosts_disable

Streams

  • streams_list, streams_create, streams_get, streams_update, streams_delete
  • streams_enable, streams_disable

Certificates

  • certificates_list, certificates_create, certificates_get, certificates_delete
  • certificates_download, certificates_renew, certificates_upload
  • certificates_validate, certificates_test_http, certificates_dns_providers

Access lists

  • access_lists_list, access_lists_create, access_lists_get, access_lists_update, access_lists_delete

Audit log

  • audit_log_list, audit_log_get

Reports

  • reports_hosts

Settings

  • settings_list, settings_get, settings_update

Local development

git clone https://github.com/warnyin/nginx-proxy-manager-mcp.git
cd nginx-proxy-manager-mcp
npm install
npm run typecheck
npm run build
node dist/index.js   # or `npm run dev` for tsx watch mode

License

MIT

S
Description
No description provided
Readme MIT
125 KiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 71.5%
Python 28.2%
JavaScript 0.3%