adf-mcp-server

Schreibgeschützter MCP-Server (Model Context Protocol) für Azure Data Factory Überwachung und Root-Cause-Analyse, entwickelt für die Nutzung mit VS Code / Claude Code.

Status: Schritt 1 (Skelett + Health-Check). Noch keine Azure-Konnektivität – das wird in Schritt 2 (Authentifizierung) und Schritt 3 (ADF-Tools) hinzugefügt.

Voraussetzungen

• Python 3.11+

Related MCP server: azure-adf-mcp

Lokale Einrichtung

cd adf-mcp-server
python -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
pip install -e ".[dev]"
cp .env.example .env

.env benötigt derzeit nur den Server-Einstellungsblock (ADF_MCP_*). Die AZURE_*-Zeilen sind Platzhalter für Schritt 2 – lassen Sie sie vorerst auskommentiert.

Server ausführen

python -m adf_mcp.server
# or, after `pip install -e .`:
adf-mcp-server

Der Server kommuniziert über stdio – wenn man ihn direkt in einem Terminal ausführt, sieht es aus, als würde er hängen; das ist erwartungsgemäß, da er auf einen MCP-Client (VS-Code-Erweiterung, Claude Code, mcp dev usw.) wartet, der sich über stdin/stdout verbindet.

Konfiguration in VS Code

Setzen Sie die Server-Konfiguration Ihrer MCP-fähigen Erweiterung auf:

{
  "command": "python",
  "args": ["-m", "adf_mcp.server"],
  "cwd": "/absolute/path/to/adf-mcp-server"
}

Sobald die Verbindung hergestellt ist, rufen Sie das Tool health_check auf – es sollte {"status": "ok", ...} zurückgeben, ohne Azure überhaupt zu berühren.

Tests ausführen

pip install -e ".[dev]" pytest-asyncio
pytest -v

Projektaufbau

Siehe src/adf_mcp/ – server.py (MCP-Transport), config.py (Einstellungen), logging_config.py (strukturierte Logging). Domänenlogik und Azure-Konnektivität werden ab Schritt 3 unter src/adf_mcp/domain/ hinzugefügt.

Fehlerbehebung

• Client zeigt sofort „Server getrennt" an: Prüfen Sie, dass python -m adf_mcp.server zuerst sauber läuft – ein Startup-Fehler beendet den Prozess, bevor der Client überhaupt eine Verbindung aufbauen kann.

• Client kann Antworten nicht parsen / verstümmelte Ausgabe: Es wurde etwas an stdout geschrieben, das nicht das MCP-Protokoll ist (z. B. ein versehentliches print()). Das gesamtes Protokollieren in diesem Projekt geht aus genau diesem Grund auf stderr.