ngnix-manager-mcp-server

<p align="center"> <img src="https://kognar.com/assets/img/logo_kognar_white.svg" alt="Kognar" width="200" /> </p> # @kognar/nginx-manager-mcp-server MCP server que abstrai chamadas à API do [Nginx Proxy Manager](https://github.com/NginxProxyManager/nginx-proxy-manager). ## Instalação ```bash npm install npm run build ``` ## Configuração Aceita via **argumentos de CLI** ou **variáveis de ambiente** (CLI tem precedência): | flag | env | descrição | | --- | --- | --- | | `--base-url` (ou `--url`) | `NPM_BASE_URL` | URL completa da API do NPM (use como está — não adicione porta) | | `--email` (ou `--user`) | `NPM_EMAIL` | email de login | | `--password` (ou `--pass`)| `NPM_PASSWORD` | senha | ```bash npx @kognar/nginx-manager-mcp-server \ --base-url https://npm.example.com \ --email admin@example.com \ --password changeme ``` ## Uso com Claude Code / Desktop Adicione no `claude_desktop_config.json` (ou `.mcp.json`): ```json { "mcpServers": { "nginx-manager": { "command": "npx", "args": [ "-y", "@kognar/nginx-manager-mcp-server", "--base-url", "https://npm.example.com", "--email", "admin@example.com", "--password", "changeme" ] } } } ``` Alternativa com env vars: ```json { "mcpServers": { "nginx-manager": { "command": "npx", "args": ["-y", "@kognar/nginx-manager-mcp-server"], "env": { "NPM_BASE_URL": "https://npm.example.com", "NPM_EMAIL": "admin@example.com", "NPM_PASSWORD": "changeme" } } } } ``` ## Tools disponíveis - **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** — idem com `redirection_host` - **404 hosts** — idem com `dead_host` - **Streams** — idem com `stream` - **Certificates** — `npm_list_certificates`, `npm_get_certificate`, `npm_create_certificate_letsencrypt`, `npm_create_certificate_custom`, `npm_renew_certificate`, `npm_test_certificate_http_reach`, `npm_delete_certificate` - **Access lists** — `npm_list_access_lists`, `npm_get_access_list`, `npm_create_access_list`, `npm_update_access_list`, `npm_delete_access_list` - **Users** — `npm_list_users`, `npm_get_user`, `npm_get_me`, `npm_create_user`, `npm_update_user`, `npm_set_user_password`, `npm_set_user_permissions`, `npm_delete_user` - **Misc** — `npm_get_settings`, `npm_get_setting`, `npm_update_setting`, `npm_get_audit_log`, `npm_get_reports_hosts`, `npm_health` ## Desenvolvimento ```bash npm run dev # executa via tsx npm run typecheck # valida tipos sem emitir ``` Autenticação usa `POST /api/tokens` com cache em memória e refresh automático 1 min antes da expiração. ## Licença [AGPL-3.0](LICENSE)