b3nw/nginx-proxy-manager-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

15 stars 14 forks 品質 72 トレンド 35

Repository Install

Nginx プロキシマネージャ用の MCP サーバー - AI アシスタントによるリバースプロキシの管理

概要

Nginx プロキシマネージャの MCP サーバー - リバースプロキシを AI アシスタントで管理します。 NPM MCPサーバーを実行する最も簡単な方法 - クローンは必要ありません! プロキシホスト作成のデフォルト値を設定します。 NPM INSTANCES を設定することにより、単一の MCP インスタンスから複数の NPM サーバーを管理します。各インスタンスオブジェクトは、api url(必須)、ID(必須)、secret(必須)、log dir(オプション)、proxy defaults(オプション)をサポートしています。 NPM INSTANCESが設定されている場合、単一インスタンスの設定(NPM API URL、NPM IDENTITY、NPM SECRET)は無視されます。すべてのツールはオプションのインスタンスパラメータを獲得します。 - 省略すると、explicit NPM DEFAULT INSTANCE(またはunsetの場合、NPM INSTANCESの最初の構成インスタンス)をターゲットにします。 list instances ツールを使用して、すべての利用可能なインスタンスを確認します。ホストの作成と更新を超えて、サーバーは、その設定を失うことなく、ホストのアウトライトを削除したり、ホストをオン/オフに切り替えることができます。 list proxy hosts でホスト ID を検索します.

概要（AI 翻訳）

Nginx プロキシマネージャの MCP サーバー - リバースプロキシを AI アシスタントで管理します。

クイックスタート(ドッカー)

NPM MCPサーバーを実行する最も簡単な方法 - クローンは必要ありません!

または直接実行して下さい:

インストール(ローカル)

設定

[env.example]を.envにコピーし、設定します。

環境変数

| 変数 | 必須 | デフォルト | 説明 | お問い合わせ | [[T2] | [T3] | NPM API エンドポイント | | [[T4] | 有り | | | NPM ユーザーメール | |【[T5] | 有り | | | NPM ユーザパスワード | | [NPM_MCP_HOST | ナンバー | [0.0.0.0] | MCP サーバーのバインドアドレス | | [[T8] | ナンバー | [8000 | MCPサーバーポート | | [[T10] | 番号 | [[T11] | 輸送モード([stdio) または [[T13] ] | | [NPM_MCP_ENABLE_DESTRUCTIVE_TOOLS | なし | [false | 書き込み/破壊ツールを有効にする(作成、更新、削除、有効、無効) | | 【[[T16]】 | ナンバー | | | | | ベアラートークンは HTTP トランスポートクライアント様向け | | [[T17] | ナンバー | | | | NPM ログディレクトリーをマウントするパス | | [NPM_PROXY_DEFAULTS | No | [{} | [[T21]JSON デフォルト設定 |

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

NPM MCP Server

MCP server for Nginx Proxy Manager - manage your reverse proxy through AI assistants.

Quick Start (Docker)

The easiest way to run the NPM MCP server - no cloning required!

# Download the compose file
curl -O https://raw.githubusercontent.com/b3nw/nginx-proxy-manager-mcp/main/compose.yaml

# Edit the environment variables, then start
docker compose up -d

Or run directly:

docker run -d \
  --name npm-mcp \
  -p 8000:8000 \
  -e NPM_API_URL=http://your-npm:81/api \
  -e [email protected] \
  -e NPM_SECRET=yourpassword \
  -e NPM_MCP_TRANSPORT=http \
  ghcr.io/b3nw/nginx-proxy-manager-mcp:latest

Installation (Local)

# Using uv (recommended)
uv pip install -e .

# Or with pip
pip install -e .

Configuration

Copy env.example to .env and configure:

NPM_API_URL=http://your-npm-instance:81/api
[email protected]
NPM_SECRET=yourpassword

# Optional: Server settings
NPM_MCP_PORT=8000
NPM_MCP_TRANSPORT=stdio  # or "http"

# Optional: Default values for create_proxy_host (JSON)
NPM_PROXY_DEFAULTS='{"certificate_id": 24, "ssl_forced": true}'

Environment Variables

Variable	Required	Default	Description
`NPM_API_URL`	Yes	`http://localhost:81/api`	NPM API endpoint
`NPM_IDENTITY`	Yes	-	NPM user email
`NPM_SECRET`	Yes	-	NPM user password
`NPM_MCP_HOST`	No	`0.0.0.0`	MCP server bind address
`NPM_MCP_PORT`	No	`8000`	MCP server port
`NPM_MCP_TRANSPORT`	No	`stdio`	Transport mode (`stdio` or `http`)
`NPM_MCP_ENABLE_DESTRUCTIVE_TOOLS`	No	`false`	Enable write/destructive tools (create, update, delete, enable, disable)
`NPM_MCP_AUTH_TOKEN`	No	-	Bearer token required for HTTP transport clients
`NPM_LOG_DIR`	No	-	Path to mounted NPM log directory (enables `get_proxy_host_logs`)
`NPM_PROXY_DEFAULTS`	No	`{}`	JSON defaults for `create_proxy_host`
`NPM_INSTANCES`	No	-	JSON map of named NPM instances for multi-instance mode (see below)
`NPM_DEFAULT_INSTANCE`	No	-	Name of the default instance for unnamed tool calls (defaults to the first instance in `NPM_INSTANCES`)

NPM_PROXY_DEFAULTS Keys

Configure default values for proxy host creation:

NPM_PROXY_DEFAULTS='{"certificate_id": 24, "ssl_forced": true, "block_exploits": true}'

Key	Type	Default	Description
`forward_scheme`	string	`"http"`	Backend protocol (`http` or `https`)
`certificate_id`	int	`0`	SSL certificate ID (use `list_certificates` to find)
`ssl_forced`	bool	`true`	Force HTTPS redirect
`block_exploits`	bool	`true`	Enable common exploit blocking
`allow_websocket_upgrade`	bool	`true`	Allow WebSocket connections

GitHub で README 全文を見る

インストール

docker run -d \

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "npm": {
      "command": "npm-mcp",
      "env": {
        "NPM_API_URL": "http://localhost:81/api",
        "NPM_IDENTITY": "[email protected]",
        "NPM_SECRET": "yourpassword"
      }
    }
  }
}