Marzban MCP: servidor MCP, instalación y seguridad

Para qué sirve Marzban MCP

Según su repositorio: «Gestionar el panel proxy/VPN Marzban: usuarios, suscripciones, nodos, hosts, configuración y estadísticas del sistema, con confirmación de llamadas destructivas.»

Un servidor MCP da a un agente IA herramientas adicionales que llama durante la conversación: el agente lee su descripción, decide usarlas y recibe el resultado. Marzban MCP figura en la categoría Plataformas cloud, que reúne 116 servidores en el directorio; ocupa el puesto 68 por número de estrellas.

Instalar y conectar Marzban MCP

Modos de distribución declarados en el registro MCP oficial:

• paquete npm (Node.js, se lanza normalmente con npx)
• imagen Docker (OCI)

Como cualquier servidor MCP, se declara en la configuración del cliente (Claude Desktop, Claude Code, Cursor, VS Code, Codex…): un nombre, el comando que lo lanza o su URL, y las variables de entorno necesarias. El cliente lo inicia y muestra sus herramientas. Lenguaje del proyecto: TypeScript.

El registro indica 2 variables secretas que aportar (clave de API, token de acceso). Guárdelas en las variables de entorno del cliente, nunca en un archivo compartido ni en un repositorio.

Seguridad: qué comprobar

Un servidor MCP ejecuta código con los permisos que le da, y el modelo lee las descripciones de sus herramientas: un servidor malicioso o comprometido puede desviar al agente. Lea el código o elija un servidor mantenido y muy usado antes de conectarlo.

Puntos detectados para Marzban MCP:

• Secretos: el servidor actúa con sus credenciales. Cree una clave dedicada, con permisos mínimos y fecha de caducidad.

Buenas prácticas: conceder solo los permisos necesarios (mínimo privilegio), exigir validación humana para las acciones irreversibles y pasar el diagnóstico de seguridad de agentes IA.

Actividad y mantenimiento del proyecto

Creado el 28 de febrero de 2025, el repositorio Ilmar7786/marzban-sdk suma 26 estrellas y 3 copias (forks), con 7 incidencias abiertas. Tiene más estrellas que el 42 % de los servidores del directorio. Ha recibido cambios este mes. Versión publicada en el registro: 0.4.0 (21 de octubre de 2026).

Las estrellas miden la atención recibida, no la calidad: un proyecto reciente y muy mediático puede acumularlas rápido, y un servidor útil pero especializado tendrá pocas.