appleby-proxy-mcp
v1.0.1
Published
MCP server for the appleby.cloud Nginx Proxy Manager, through proxy-api (repo: proxy-mcp)
Maintainers
Readme
proxy-mcp
MCP server for the appleby.cloud Nginx Proxy Manager — 43 typed tools over proxy-api.
appleby.cloud platform · MCP server · npm
appleby-proxy-mcp
Overview
Gives agents (pi, Claude Code) the Nginx Proxy Manager on aplb-proxy: proxy, redirection and
404 hosts, streams, certificates, access lists, the default site, NPM's log viewer and its audit
log. Every call goes through proxy-api's /npm/v1
facade, which authenticates with Forta, enforces an allowlist, redacts credentials and records
every write in Monitor. NPM's own credentials never reach this server.
The npm name is appleby-proxy-mcp — proxy-mcp on npm is an unrelated package.
Role in the appleby.cloud ecosystem
One of the platform *-mcp servers (lattice, monitor, forta, keyring, openbucket, proxy). It
holds no logic: request shapes come from NPM 2.16's /api/schema, permissions from proxy-api.
Tech stack
Node ≥ 18 (ESM) · @modelcontextprotocol/sdk · zod
Getting started
Prerequisites
- A Forta API token (
frt_…) whose owner holds a grant on the APLB Proxy Manager platform (Forta id 11). - LAN access to
proxy-api.appleby.cloud(LAN-only DNS).
Setup
npx appleby-proxy-mcp --setup # writes the "proxy" block into ~/.mcp.jsonOr by hand: command: npx, args: ["-y", "appleby-proxy-mcp"], env PROXY_API_URL
(https://proxy-api.appleby.cloud) and PROXY_API_TOKEN. In agent-config it is the proxy
entry in mcp/servers.json, reusing ${FORTA_API_TOKEN}.
Development
| Command | What it does |
|---------|--------------|
| npm install | Install the two dependencies |
| npm test | verify.mjs: syntax, tool names/counts, versions, masking, proxy-api's boundary |
| node index.js --setup | Interactive setup |
| PROXY_API_URL=… PROXY_API_TOKEN=… node index.js | Run on stdio |
Tools
Health & reports
| Tool | What it does |
|------|--------------|
| proxy_health | proxy-api's own healthcheck |
| proxy_check_version | NPM's version and whether a newer release exists |
| proxy_get_host_report | Host counts by type |
Proxy hosts
| Tool | What it does |
|------|--------------|
| proxy_list_proxy_hosts | List (optionally expand access_list / owner / certificate) |
| proxy_get_proxy_host | One host with advanced config and locations |
| proxy_create_proxy_host | Create (Forta gate recipe in the description) |
| proxy_update_proxy_host | Partial update; advanced_config and locations replace wholesale |
| proxy_enable_proxy_host / proxy_disable_proxy_host | Toggle |
| proxy_delete_proxy_host | Delete |
Redirection & 404 hosts, streams
| Tool | What it does |
|------|--------------|
| proxy_list_redirection_hosts, proxy_get_redirection_host | Read |
| proxy_create_redirection_host, proxy_update_redirection_host, proxy_delete_redirection_host | Write |
| proxy_enable_redirection_host, proxy_disable_redirection_host | Toggle |
| proxy_list_dead_hosts, proxy_create_dead_host, proxy_update_dead_host, proxy_delete_dead_host | 404 hosts |
| proxy_list_streams, proxy_create_stream, proxy_update_stream, proxy_delete_stream | TCP/UDP streams |
Certificates
| Tool | What it does |
|------|--------------|
| proxy_list_certificates, proxy_get_certificate | Read (keys and DNS credentials redacted) |
| proxy_list_dns_providers | Certbot DNS plugins |
| proxy_create_certificate | Let's Encrypt request (prefer the existing *.appleby.cloud wildcard) |
| proxy_renew_certificate | Renew now |
| proxy_test_http_challenge | HTTP-01 reachability check |
| proxy_delete_certificate | Delete |
Downloading and uploading certificates are deliberately unavailable.
Access lists & settings
| Tool | What it does |
|------|--------------|
| proxy_list_access_lists, proxy_get_access_list | Read (passwords redacted) |
| proxy_create_access_list, proxy_update_access_list, proxy_delete_access_list | Write |
| proxy_list_settings | Settings |
| proxy_update_default_site | What unknown hostnames get |
Logs & audit
| Tool | What it does |
|------|--------------|
| proxy_list_log_sources | What the log viewer can read |
| proxy_tail_log | Tail system, Let's Encrypt or a host's access/error log |
| proxy_list_audit_log, proxy_get_audit_log_entry | NPM's audit trail |
For request history and analytics use Monitor (service proxy, zone appleby).
Deployment
Publishing is deployment: npm publish (2FA passkey, interactive terminal). Clients pick up a
new version only after they restart.
