mcp-netdisco

Ein Docker-basierter Model Context Protocol (MCP)-Server, der MCP-Clients schreibgeschützten Zugriff auf Netdisco gewährt.

Funktionen

• Verwendet den /login-Endpunkt von Netdisco mit HTTP-Basic-Zugangsdaten

• Zwischenspeichert den zurückgegebenen API-Schlüssel und erneuert ihn alle 30 Tage

• Authentifiziert sich automatisch neu, wenn Netdisco HTTP 401 zurückgibt

• Beschränkt Anfragen auf relative Pfade auf dem konfigurierten Netdisco-Server

• Läuft über MCP stdio für Clients, die Docker-Container starten

Related MCP server: kismet-wireless-mcp

Konfiguration

Erstellen Sie eine .env-Datei. Die Standard-URL ist der Produktions-Netdisco-Server:

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

Benutzername und Passwort werden ausschließlich verwendet, um einen API-Schlüssel von POST /login zu erhalten. Committen Sie .env nicht.

Docker

Direkt bauen und ausführen:

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

Oder verwenden Sie Compose:

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

MCP-Tool

Der Server stellt Folgendes bereit:

netdisco_api(path, query)

• path: ein relativer Netdisco-API-Pfad, z. B. /api/v1/search/device

• query: optionale Query-String-Parameter

Für Datenabrufe werden nur HTTP-GET-Anfragen unterstützt. Absolute URLs werden abgelehnt, und Anfragen können nicht auf einen anderen Host umgeleitet werden.

Lebensdauer des Netdisco-Tokens

Der Server erneuert seinen zwischengespeicherten API-Schlüssel alle 30 Tage und versucht es nach einer 401-Antwort einmal erneut. Die Einstellung api_token_lifetime von Netdisco muss länger sein als das Erneuerungsintervall (andernfalls erhält der 401-Wiederholungsversuch bei Bedarf einen neuen Schlüssel). Das Erneuerungsintervall kann später bei Bedarf konfigurierbar gemacht werden.

Entwicklung

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

Lizenz

Es wurde noch keine Lizenz ausgewählt.