Nginx Proxy Manager MCP

Name: Nginx Proxy Manager MCP
Author: euisuh

作者：euisuhバージョン 0.5.2i★ –iパソコンで動く

レジストリ名io.github.euisuh/nginx-proxy-manager-mcp

インストール

概要

作者による説明（英語の原文）

Manage Nginx Proxy Manager hosts, certificates, streams and access lists with dry-run previews.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: その他
入力が必要なもの：NPM_URL, NPM_EMAIL, NPM_PASSWORD

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： NPM_URL, NPM_EMAIL, NPM_PASSWORD, MCP_TRANSPORT

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

PyPIPythonのuvのインストール（uvxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "nginx-proxy-manager": {
      "command": "uvx",
      "args": [
        "nginx-proxy-manager-mcp-server"
      ],
      "env": {
        "NPM_URL": "your-value",
        "NPM_EMAIL": "your-value",
        "NPM_PASSWORD": "your-value",
        "MCP_TRANSPORT": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add nginx-proxy-manager --env NPM_URL=your-value --env NPM_EMAIL=your-value --env NPM_PASSWORD=your-value --env MCP_TRANSPORT=your-value -- uvx nginx-proxy-manager-mcp-server

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "nginx-proxy-manager": {
      "command": "uvx",
      "args": [
        "nginx-proxy-manager-mcp-server"
      ],
      "env": {
        "NPM_URL": "your-value",
        "NPM_EMAIL": "your-value",
        "NPM_PASSWORD": "your-value",
        "MCP_TRANSPORT": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "nginx-proxy-manager": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "nginx-proxy-manager-mcp-server"
      ],
      "env": {
        "NPM_URL": "your-value",
        "NPM_EMAIL": "your-value",
        "NPM_PASSWORD": "your-value",
        "MCP_TRANSPORT": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

NPM_URL 必須 env
Base URL of the Nginx Proxy Manager admin API
NPM_EMAIL 必須 env
Existing NPM admin email
NPM_PASSWORD 秘密必須 env
Existing NPM admin password
MCP_TRANSPORT env
Must be stdio when launched by an MCP client

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント euisuh で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

その他のほかのサーバーとの比較i

このカテゴリのほかの32691件のうち0%よりスターが多い
このカテゴリのほかの32691件のうち64%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの32691件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Nginx Proxy Manager MCPは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：NPM_URL, NPM_EMAIL, NPM_PASSWORD

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.5.2）がレジストリに届いたのは22 日前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは？

同じカテゴリには：Spec Driven Development, Remote Desktop Commander, Dialyne

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Spec Driven Development

作者：formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

パソコンで動く★ 440MIT14 か月前更新

インストール

Remote Desktop Commander

作者：desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

クラウドで動く★ 211一昨日更新

インストール

Dialyne

作者：dialyne

Real phone calls in France for AI agents: dial +33 numbers, menus, hold, AI disclosure.

クラウドで動く今日更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Nginx Proxy Manager MCP

An MCP server for Nginx Proxy Manager. It lets Claude and other MCP clients manage proxy hosts, redirection hosts, TCP/UDP streams, Let's Encrypt certificates, and access lists through typed tools instead of clicking through the NPM admin UI.

"Point blog.example.com at the container on port 3000 with HTTPS"

│ ▼ Claude / MCP client ──► Nginx Proxy Manager MCP ──HTTP + JWT──► NPM API

The demo calls create_proxy_host_with_letsencrypt(dry_run=True) against a mocked NPM API and prints both request previews. No real NPM instance or credentials are used. To record it again, install the development dependencies and VHS, then run vhs docs/demo.tape from the repository root; docs/demo.py uses the same respx mocking approach as the tests.

Why this exists

Reverse-proxy changes are repetitive homelab work: create a host, point it at a container, attach a certificate, maybe restrict it to an access list. That is exactly the kind of operational task an AI assistant can handle well when it has narrow, typed tools and a local admin boundary.

This server runs either:

as an SSE Docker sidecar next to an existing NPM container, or
as a stdio MCP server for local clients.

Features

34 MCP tools for common NPM operations (table below).
dry_run on all mutating tools to preview NPM requests before applying them.
One-shot create_proxy_host_with_letsencrypt requests a certificate, then creates an HTTPS-forced proxy host.
Let's Encrypt over HTTP-01 or DNS-01 (wildcards), with the request shape picked from the NPM version reported by GET /api/.
NPM_READ_ONLY=true registers only the 12 list_/get_/find_ tools.
JWT auth against the NPM API with in-memory token caching and automatic re-authentication on 401.
Docker sidecar deployment that binds the MCP port to localhost by default.
Offline pytest suite with mocked NPM API responses, including end-to-end calls through the MCP protocol layer; CI runs it on Python 3.10–3.13.
Ruff quality gate and contributor templates for public maintenance.
Python wheel build validation and MCP directory metadata for promotion readiness.
No token persistence and no hardcoded credentials.

Tools

Tool	Category	Read-only	Description
`list_proxy_hosts`	Proxy hosts	yes	List proxy hosts configured in NPM, including their current status.
`get_proxy_host`	Proxy hosts	yes	Fetch one proxy host by ID, including its configured fields and current status.
`create_proxy_host`	Proxy hosts		Create a proxy host that routes the supplied domains to an HTTP or HTTPS upstream.
`create_proxy_host_with_letsencrypt`	Proxy hosts		Request a Let's Encrypt certificate, then create a proxy host using that certificate with HTTPS forced.
`update_proxy_host`	Proxy hosts		Update writable settings on an existing proxy host by ID.
`delete_proxy_host`	Proxy hosts		Permanently delete a proxy host by ID, removing its configured domain routing from NPM.
`enable_proxy_host`	Proxy hosts		Enable a disabled proxy host by ID so NPM serves its configured domain routing again.
`disable_proxy_host`	Proxy hosts		Disable a proxy host by ID while retaining its configuration.
`list_certificates`	Certificates	yes	List SSL certificates known to NPM, including expiry information when provided by NPM.
`get_certificate`	Certificates	yes	Fetch one certificate by ID, including provider, domain names, expiry and meta.
`create_letsencrypt_cert`	Certificates		Request a new Let's Encrypt certificate for the supplied domains, over HTTP-01 by default or DNS-01 with dns_challenge=True (required for wildcards).
`delete_certificate`	Certificates		Permanently delete a certificate by ID, for example one left behind when create_proxy_host_with_letsencrypt fails at the proxy step.
`renew_certificate`	Certificates		Request renewal of an existing certificate by ID.
`list_access_lists`	Access lists	yes	List access lists configured in NPM.
`get_access_list`	Access lists	yes	Fetch one access list by ID, including its client rules and basic-auth user metadata.
`create_access_list`	Access lists		Create an access list containing optional IP allow/deny rules and basic-auth users.
`update_access_list`	Access lists		Update writable fields on an existing access list by ID, including client rules and basic-auth users.
`delete_access_list`	Access lists		Permanently delete an access list by ID from NPM.
`list_redirection_hosts`	Redirection hosts	yes	List configured redirection hosts and their current status.
`get_redirection_host`	Redirection hosts	yes	Fetch one redirection host by ID with its configured destination and status.
`create_redirection_host`	Redirection hosts		Create a host that redirects requests for domains to a destination using the selected HTTP status.
`update_redirection_host`	Redirection hosts		Update writable settings on an existing redirection host by ID.
`delete_redirection_host`	Redirection hosts		Permanently delete a redirection host by ID, removing its redirect configuration from NPM.
`enable_redirection_host`	Redirection hosts		Enable a disabled redirection host by ID so NPM serves its redirect again.
`disable_redirection_host`	Redirection hosts		Disable a redirection host by ID while keeping its configuration in NPM.
`list_streams`	Streams	yes	List configured TCP/UDP streams and their current status.
`get_stream`	Streams	yes	Fetch one TCP/UDP stream by ID, including its forwarding ports and protocol settings.
`create_stream`	Streams		Create a TCP/UDP port forward from an incoming port to a destination host and port.
`update_stream`	Streams		Update writable port, destination, or protocol fields on an existing stream by ID.
`delete_stream`	Streams		Permanently delete a TCP/UDP stream by ID; NPM stops forwarding that port immediately and this cannot be undone.
`enable_stream`	Streams		Enable a disabled TCP/UDP stream by ID so NPM forwards its incoming port again.
`disable_stream`	Streams		Disable a TCP/UDP stream by ID while retaining its forwarding configuration.
`find_host_by_domain`	Diagnostics	yes	Find proxy hosts, redirection hosts, and certificates serving a domain using exact or wildcard matching.
`list_expiring_certificates`	Diagnostics	yes	List certificates expiring within the requested UTC time window, including certificates already expired, sorted by expiry.

The table is generated by docs/tools_table.py from the registered tools; tests/test_readme.py fails if it drifts. Read-only tools are the ones NPM_READ_ONLY keeps.

List tools support optional server-side filtering after fetching from NPM: domain matches a case-insensitive substring in any domain name for proxy hosts, redirection hosts, and certificates; enabled filters proxy hosts, redirection hosts, and streams by status. All four accept compact=True to return only summary fields. Filters combine, and calls without arguments return the full, unchanged NPM list. For example, list_proxy_hosts(domain="example", enabled=True, compact=True) lists enabled hosts matching "example" with compact output.

All mutating tools expose dry_run=True. Previews contain method and path, plus json when the request has a body; the HTTPS workflow returns two previews in steps. The flag suppresses mutating requests, though some previews read current state. Update tools send only the fields in NPM's PUT schema (fixes #19); this is covered by mocked tests and not yet checked against a live NPM instance.

Compared to other NPM MCP servers

Competitor facts below come only from their linked READMEs fetched with gh api repos/ /nginx-proxy-manager-mcp/readme on 2026-10-13. “not documented” means the README does not establish the capability, not that it is absent. Auth guard means inbound MCP client authentication, distinct from NPM API login.

Repository	Tool count documented	Dry-run support	Transport	Auth guard
euisuh (this server)	34	`dry_run` on all mutating tools	stdio, SSE	Optional SSE bearer token (`MCP_BEARER_TOKEN`); `/healthz` exempt
b3nw	14 named tools (13 catalog rows plus `list_instances`)	not documented	stdio, HTTP	HTTP bearer token (`NPM_MCP_AUTH_TOKEN`)
omichelbraga	66	DELETE without `confirm: true` previews affected resources; general `dry_run` not documented	stdio, Streamable HTTP	Optional bearer token (`NPM_MCP_BEARER_TOKEN`); unset means no inbound auth
drmogie	4 named tools (`npm_status`, `npm_hosts`, `npm_audit_log`, `npm_call`)	Changes show what will be sent and require `confirm`; `dry_run` not documented	not documented	not documented

This server's implementations expose dry_run on every mutating tool, provide the one-shot create_proxy_host_with_letsencrypt workflow, and publish the Docker sidecar at 127.0.0.1:8000:8000. These are verified in tools/, server.py, and docker-compose.yml. They do not establish that other servers lack equivalent capabilities.

Quick start: Docker sidecar

The bundled docker-compose.yml starts both Nginx Proxy Manager and this MCP sidecar from source. If you already run NPM, copy only the nginx-proxy-manager-mcp service into your existing compose file.

git clone https://github.com/euisuh/nginx-proxy-manager-mcp.git

cd nginx-proxy-manager-mcp cp .env.example .env

edit .env — NPM_EMAIL / NPM_PASSWORD of an existing NPM user (a dedicated non-admin user works; see Security)

docker compose up -d

NPM_URL defaults to http://app:81, the NPM admin API on the internal Docker network. Leave it as-is when both services share a compose stack; point it at your NPM host otherwise.

To use the published GHCR image instead of building locally:

services:

nginx-proxy-manager-mcp: image: ghcr.io/euisuh/nginx-proxy-manager-mcp:latest restart: unless-stopped environment: NPM_URL: http://app:81 NPM_EMAIL: ${NPM_EMAIL} N

冒頭だけを表示しています。続きはリポジトリで読めます

Nginx Proxy Manager MCP

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

その他のほかのサーバーとの比較i

よくある質問

代わりの候補

Spec Driven Development

Remote Desktop Commander

Dialyne

作者のREADME

Nginx Proxy Manager MCP

Why this exists

Features

Tools

Compared to other NPM MCP servers

Quick start: Docker sidecar

edit .env — NPM_EMAIL / NPM_PASSWORD of an existing NPM user (a dedicated non-admin user works; see Security)