Which integrations are available for this server?

Allows managing an Nginx Proxy Manager instance, including proxy hosts, redirection hosts, dead hosts, streams, access lists, certificates, users, and settings.

How do I use Nginx Proxy Manager MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Nginx Proxy Manager MCP Server list all my proxy hosts" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Nginx Proxy Manager MCP Server

by nice-winter

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

Nginx Proxy Manager MCP Server

一个用于管理 Nginx Proxy Manager 的 Model Context Protocol (MCP) 服务器。

✨ 特性

🔐 自动 JWT 刷新：在 token 即将过期时自动刷新，避免多轮对话中认证失败
🛠️ 完整的 API 覆盖：支持 Proxy Hosts、Redirection Hosts、Dead Hosts、Streams 等所有资源
📝 支持 advanced_config：创建/更新记录时完全支持 advanced_config 和 locations[].advanced_config
🔄 自动重试：收到 401 错误时自动重新登录并重试请求
🌐 多种传输模式：支持 stdio 和 Streamable HTTP 两种模式
🔧 灵活配置：支持命令行参数、环境变量、HTTP Headers 多种配置方式

Related MCP server: npm-mcp

📋 支持的 Tools

类别	Tools
Proxy Hosts	`npm_list_proxy_hosts`, `npm_get_proxy_host`, `npm_create_proxy_host`, `npm_update_proxy_host`, `npm_delete_proxy_host`, `npm_enable_proxy_host`, `npm_disable_proxy_host`
Redirection Hosts	`npm_list_redirection_hosts`, `npm_get_redirection_host`, `npm_create_redirection_host`, `npm_update_redirection_host`, `npm_delete_redirection_host`, `npm_enable_redirection_host`, `npm_disable_redirection_host`
Dead Hosts	`npm_list_dead_hosts`, `npm_get_dead_host`, `npm_create_dead_host`, `npm_update_dead_host`, `npm_delete_dead_host`, `npm_enable_dead_host`, `npm_disable_dead_host`
Streams	`npm_list_streams`, `npm_get_stream`, `npm_create_stream`, `npm_update_stream`, `npm_delete_stream`, `npm_enable_stream`, `npm_disable_stream`
Access Lists	`npm_list_access_lists`, `npm_get_access_list`, `npm_create_access_list`, `npm_update_access_list`, `npm_delete_access_list`
Certificates	`npm_list_certificates`, `npm_get_certificate`, `npm_create_certificate`, `npm_delete_certificate`, `npm_renew_certificate`, `npm_list_dns_providers`, `npm_test_http_challenge`
Users	`npm_list_users`, `npm_get_user`, `npm_create_user`, `npm_update_user`, `npm_delete_user`, `npm_get_user_permissions`, `npm_set_user_permissions`
Settings	`npm_list_settings`, `npm_get_setting`, `npm_update_setting`, `npm_list_audit_log`, `npm_get_report`

🚀 快速开始

1. 安装依赖

pnpm install

2. 配置环境变量（可选）

对于 stdio 模式，需要配置 NPM 连接信息。对于 Streamable HTTP 模式，可以通过 HTTP Headers 提供配置。

复制 .env.example 到 .env：

cp .env.example .env

.env 文件内容：

# Nginx Proxy Manager Configuration
NPM_BASE_URL=http://your-npm-server:81
NPM_USERNAME=admin@example.com
NPM_PASSWORD=your_password

# Optional: Token refresh margin in seconds (default: 300 = 5 minutes)
NPM_TOKEN_REFRESH_MARGIN=300

# MCP Transport Configuration
# Options: stdio (default), streamable-http
MCP_TRANSPORT=stdio

# Streamable HTTP Configuration (only used when MCP_TRANSPORT=streamable-http)
MCP_HTTP_HOST=0.0.0.0
MCP_HTTP_PORT=1234
# Optional: Auth token for HTTP mode (clients must send Authorization: Bearer <token>)
MCP_HTTP_AUTH_TOKEN=

3. 编译

pnpm run build

4. 运行

stdio 模式（默认，适合 Claude Desktop）：

pnpm run start

Streamable HTTP 模式（适合远程访问）：

pnpm run start:http

🔧 配置方式

配置优先级（从高到低）：

命令行参数 - --base-url, --username, --password
环境变量 / .env 文件 - NPM_BASE_URL, NPM_USERNAME, NPM_PASSWORD
HTTP Headers - NPM-Base-Url, NPM-Username, NPM-Password（仅 Streamable HTTP 模式）

命令行参数

# stdio 模式
node dist/index.js --base-url http://10.0.1.199:81 --username admin@example.com --password mypassword

# Streamable HTTP 模式
node dist/index.js --transport streamable-http --host 0.0.0.0 --port 1234 --base-url http://10.0.1.199:81 --username admin@example.com --password mypassword

支持的参数：

--base-url - NPM 服务器地址
--username - NPM 用户名
--password - NPM 密码
--transport - 传输模式 (stdio 或 streamable-http)
--host - HTTP 监听地址 (默认 0.0.0.0)
--port - HTTP 端口
--auth-token - MCP 认证 token

HTTP Headers（Streamable HTTP 模式）

当环境变量未配置时，客户端可以通过 HTTP Headers 提供 NPM 配置：

{
  "mcpServers": {
    "nginx-proxy-manager": {
      "type": "streamable-http",
      "url": "http://localhost:1234/mcp",
      "headers": {
        "NPM-Base-Url": "http://10.0.1.199:81",
        "NPM-Username": "admin@example.com",
        "NPM-Password": "password123"
      }
    }
  }
}

优势：

无需在服务器端配置 .env
不同客户端可以连接不同的 NPM 服务器
适合多租户场景

环境变量（stdio 模式）

对于 stdio 模式，MCP 客户端通常通过 env 字段传递配置：

{
  "mcpServers": {
    "nginx-proxy-manager": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "NPM_BASE_URL": "http://10.0.1.199:81",
        "NPM_USERNAME": "admin@example.com",
        "NPM_PASSWORD": "password123"
      }
    }
  }
}

🌐 Streamable HTTP 模式

Streamable HTTP 模式允许通过 HTTP 访问 MCP Server，适合远程访问和团队共享。

启动

# 使用 .env 配置
pnpm run start:http

# 使用命令行参数
node dist/index.js --transport streamable-http --host 0.0.0.0 --port 1234

API 端点

URL: http://<MCP_HTTP_HOST>:<MCP_HTTP_PORT>/mcp
Methods: POST, GET, DELETE
Content-Type: application/json
Accept: application/json, text/event-stream

认证

可选的 MCP 认证 token 保护：

# 通过环境变量
MCP_HTTP_AUTH_TOKEN=your-secret-token pnpm run start:http

# 通过命令行参数
node dist/index.js --transport streamable-http --auth-token your-secret-token

客户端配置：

{
  "mcpServers": {
    "nginx-proxy-manager": {
      "type": "streamable-http",
      "url": "http://localhost:1234/mcp",
      "headers": {
        "Authorization": "Bearer your-secret-token",
        "NPM-Base-Url": "http://10.0.1.199:81",
        "NPM-Username": "admin@example.com",
        "NPM-Password": "password123"
      }
    }
  }
}

🔐 JWT 自动刷新机制

为了解决 Agent 多轮调用中 JWT 过期的问题，本 MCP Server 实现了以下机制：

提前刷新：在 token 即将过期前 5 分钟（可配置）自动刷新
自动重试：收到 401 错误时自动重新登录并重试请求
并发安全：多个请求同时触发刷新时，只会执行一次刷新

配置刷新间隔

在 .env 中设置 NPM_TOKEN_REFRESH_MARGIN（单位：秒）：

# 在 token 过期前 5 分钟刷新（默认值）
NPM_TOKEN_REFRESH_MARGIN=300

# 在 token 过期前 10 分钟刷新
NPM_TOKEN_REFRESH_MARGIN=600

📝 使用示例

创建带 advanced_config 的 Proxy Host

{
  "name": "npm_create_proxy_host",
  "arguments": {
    "domain_names": ["app.example.com"],
    "forward_scheme": "http",
    "forward_host": "127.0.0.1",
    "forward_port": 8080,
    "advanced_config": "proxy_set_header Host $host;\nproxy_set_header X-Real-IP $remote_addr;",
    "locations": [
      {
        "path": "/api",
        "forward_scheme": "http",
        "forward_host": "backend.local",
        "forward_port": 3000,
        "advanced_config": "proxy_set_header X-API-Key secret;"
      }
    ]
  }
}

更新 Proxy Host 的 advanced_config

{
  "name": "npm_update_proxy_host",
  "arguments": {
    "host_id": 1,
    "advanced_config": "# Updated config\nproxy_buffering off;",
    "locations": [
      {
        "path": "/",
        "forward_scheme": "http",
        "forward_host": "10.0.1.101",
        "forward_port": 3000,
        "advanced_config": "proxy_set_header Host $host:60443;"
      }
    ]
  }
}

🚀 systemd 服务（开机启动）

Streamable HTTP 模式下，可以配置为 systemd 服务实现开机自动启动。

安装服务

# 编译项目
pnpm run build

# 安装 systemd 服务
pnpm run service:install

管理服务

# 启动/停止/重启
sudo systemctl start npm-mcp
sudo systemctl stop npm-mcp
sudo systemctl restart npm-mcp

# 查看状态
sudo systemctl status npm-mcp

# 查看日志（实时）
journalctl -u npm-mcp -f

开机启动控制

# 启用开机启动
sudo systemctl enable npm-mcp

# 禁用开机启动
sudo systemctl disable npm-mcp

卸载服务

pnpm run service:uninstall

🔧 开发

开发模式运行

# stdio 模式
pnpm run dev

# Streamable HTTP 模式
pnpm run dev:http

项目结构

mcp/
├── src/
│   ├── index.ts              # MCP Server 主入口
│   ├── npm-client.ts         # NPM API 客户端（含 JWT 自动刷新）
│   ├── types.ts              # TypeScript 类型定义
│   └── tools/
│       ├── proxy-hosts.ts    # Proxy Hosts tools
│       ├── redirection-hosts.ts  # Redirection Hosts tools
│       ├── dead-hosts.ts     # Dead Hosts tools
│       ├── streams.ts        # Streams tools
│       ├── access-lists.ts   # Access Lists tools
│       ├── certificates.ts   # Certificates tools
│       ├── users.ts          # Users tools
│       └── settings.ts       # Settings tools
├── scripts/
│   └── setup-systemd.sh      # systemd 服务安装脚本
├── docs/                     # API 文档
├── package.json
├── tsconfig.json
└── .env                      # 环境变量配置（可选）

📚 API 文档

详细的 API 文档请参考 docs/ 目录：

README.md - API 概览
auth.md - 认证与令牌
proxy-hosts.md - Proxy Hosts API
redirection-hosts.md - Redirection Hosts API
dead-hosts.md - Dead Hosts API
streams.md - Streams API
access-lists.md - Access Lists API
certificates.md - Certificates API
users.md - Users API
settings.md - Settings API

📄 License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

OneDroid SynapseOAuth
ai.onedroid
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
Security Observability
1
ClearPolicyOAuth
app.clearpolicy
Authenticated MCP server for ClearPolicy policy and compliance workflows.
Legal & Compliance Security
2
VoteShip A
io.github.MattKilmer
Manage feature requests, votes, roadmaps, and changelogs from any MCP client.
Product Management Project Management
41
auth-token-service B
io.github.mikerawsonnz
Hash passwords with bcrypt and issue/verify JWT session tokens over A2A + MCP.
Security Developer Tools
21

Related MCP Servers

Nginx Proxy Manager MCP
Developer Tools App Automation Cloud Platforms
VeryBigSad
A
license
B
quality
C
maintenance
Enables management of Nginx Proxy Manager instances for configuring proxy hosts, requesting Let's Encrypt SSL certificates, and managing access lists. It allows users to control their web proxy infrastructure through natural language commands in MCP-compatible environments.
Updated 6 months ago (2026-03-02 00:34 UTC)
50
3
MIT
npm-mcp
Networking & Infrastructure Developer Tools
wadew
A
license
Not graded
quality
D
maintenance
Enables AI assistants to manage Nginx Proxy Manager instances through natural language, covering 28 tools for proxy hosts, certificates, streams, and more.
Updated 8 months ago (2026-01-16 14:17 UTC)
MIT
@kognar/nginx-manager-mcp
Networking & Infrastructure Security
kognar-ai
A
license
C
quality
D
maintenance
MCP server that abstracts the Nginx Proxy Manager API, enabling management of proxy hosts, redirections, streams, certificates, access lists, and users through natural language.
Updated a month ago (2026-08-04 09:29 UTC)
54
16
1
AGPL 3.0
npm-mcp
Networking & Infrastructure Security
crogers2287
A
license
Not graded
quality
D
maintenance
Enables AI assistants to manage Nginx Proxy Manager, including proxy hosts, SSL certificates, streams, and more.
Updated 9 months ago (2025-11-26 00:08 UTC)
13
ISC

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nice-winter/node-nginx-proxy-manager-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Nginx Proxy Manager MCP Server

✨ 特性

📋 支持的 Tools

🚀 快速开始

1. 安装依赖

2. 配置环境变量（可选）

3. 编译

4. 运行

🔧 配置方式

命令行参数

HTTP Headers（Streamable HTTP 模式）

环境变量（stdio 模式）

🌐 Streamable HTTP 模式

启动

API 端点

认证

🔐 JWT 自动刷新机制

配置刷新间隔

📝 使用示例

创建带 advanced_config 的 Proxy Host

更新 Proxy Host 的 advanced_config

🚀 systemd 服务（开机启动）

安装服务

管理服务

开机启动控制

卸载服务

🔧 开发

开发模式运行

项目结构

📚 API 文档

📄 License

Tool Schema Changelog

Maintenance

Resources

Looking for Admin?

Related MCP Connectors

Related MCP Servers

Nginx Proxy Manager MCP

npm-mcp

@kognar/nginx-manager-mcp

npm-mcp

Latest Blog Posts

MCP directory API