mcp-netdisco

Un servidor Dockerizado Model Context Protocol (MCP) que brinda a los clientes MCP acceso de solo lectura a Netdisco.

Características

• Usa el endpoint /login de Netdisco con credenciales HTTP Basic

• Almacena en caché la clave de API devuelta y la actualiza cada 30 días

• Se vuelve a autenticar automáticamente si Netdisco devuelve HTTP 401

• Restringe las solicitudes a rutas relativas en el servidor Netdisco configurado

• Se ejecuta a través de MCP stdio para clientes que lanzan contenedores Docker

Related MCP server: kismet-wireless-mcp

Configuración

Crea un archivo .env. La URL predeterminada es el servidor Netdisco de producción:

NETDISCO_URL=http://your-url-site.com:5000
NETDISCO_USERNAME=your-netdisco-username
NETDISCO_PASSWORD=your-netdisco-password
NETDISCO_TIMEOUT=20

El nombre de usuario y la contraseña se usan únicamente para obtener una clave de API de POST /login. No hagas commit de .env.

Docker

Construye y ejecuta directamente:

docker build -t mcp-netdisco .
docker run --rm -i --env-file .env mcp-netdisco

O usa Compose:

docker compose build
docker compose run --rm -T mcp-netdisco

Herramienta MCP

El servidor expone:

netdisco_api(path, query)

• path: una ruta relativa de la API de Netdisco, como /api/v1/search/device

• query: parámetros opcionales de la cadena de consulta

Solo se admiten solicitudes HTTP GET para llamadas de datos. Las URL absolutas se rechazan y las solicitudes no pueden redirigir a otro host.

Duración del token de Netdisco

El servidor actualiza su clave de API en caché cada 30 días y reintenta una vez después de una respuesta 401. El ajuste api_token_lifetime de Netdisco debe ser mayor que el intervalo de actualización (o el reintento de 401 obtendrá una clave nueva cuando sea necesario). El intervalo de actualización puede hacerse configurable más adelante si es necesario.

Desarrollo

python3 -m venv .venv
. .venv/bin/activate
pip install -e .
export NETDISCO_USERNAME=your-user
export NETDISCO_PASSWORD=your-password
python -m mcp_netdisco

Licencia

Aún no se ha seleccionado ninguna licencia.