SAP RCA MCP Server

Python-MCP-Server, der KI-Agenten die Durchführung von Root Cause Analysis auf SAP-Systemen ermöglicht, indem er Azure Log Analytics-Daten abfragt.

Architektur

AI Agent (Azure AI Foundry / Claude / Copilot Studio)
    │  MCP Tool Calls
    ▼
FastMCP Server (server.py)
    ├── get_schema        → schema_registry.py  (table/column metadata)
    ├── execute_query     → la_client.py         (validated KQL execution)
    ├── analyze_results   → domain_knowledge.py  (SAP error classification)
    └── run_full_rca      → rca_orchestrator.py  (8-step automated workflow)
    │
    ▼
Azure Log Analytics (read-only KQL queries via Managed Identity)

Related MCP server: exception-mcp-server

Die 4 Tools

Voraussetzungen

• Python 3.11+

• Azure CLI (az) installiert

• Zugriff auf den Azure Log Analytics-Arbeitsbereich (Workspace-ID erforderlich)

• Rolle Log Analytics Reader Ihrem Konto zugewiesen (oder Managed Identity)

Einrichtung

# 1. Clone / navigate to this folder
cd C:\Users\padmajat\Documents\AMS-Agentic-RCA\MCP

# 2. Create virtual environment
python -m venv .venv
.venv\Scripts\activate          # Windows
# source .venv/bin/activate     # Linux/macOS

# 3. Install dependencies
pip install -r requirements.txt

# 4. Configure
copy .env.example .env
# Edit .env and fill in AZURE_LOG_ANALYTICS_WORKSPACE_ID and AZURE_TENANT_ID

# 5. Authenticate (local development)
az login

Konfiguration (.env)

AZURE_LOG_ANALYTICS_WORKSPACE_ID=<your-workspace-guid>
AZURE_TENANT_ID=<your-tenant-id>

Bei Azure mit Managed Identity wird nur die Workspace-ID benötigt – lassen Sie alle AZURE_CLIENT_*-Felder leer.

Ausführung

stdio-Modus (Claude Desktop, MCP Inspector, Azure AI Foundry lokal)

python server.py
# or:
mcp dev server.py

SSE/HTTP-Modus (Azure App Service-Bereitstellung)

pip install uvicorn
uvicorn server:mcp --host 0.0.0.0 --port 8000

Der SSE-Endpunkt lautet: http://localhost:8000/sse

Verbindung zu Claude Desktop

Fügen Sie zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "sap-rca": {
      "command": "python",
      "args": ["C:/Users/padmajat/Documents/AMS-Agentic-RCA/MCP/server.py"],
      "env": {
        "AZURE_LOG_ANALYTICS_WORKSPACE_ID": "<your-workspace-id>",
        "AZURE_TENANT_ID": "<your-tenant-id>"
      }
    }
  }
}

Verbindung zu Azure AI Foundry

Fügen Sie in Azure AI Foundry eine MCP-Verbindung hinzu, die auf https://<your-app-service>.azurewebsites.net/sse zeigt.

Beispiel für eine Agenten-Konversation

Fokussierter Abfrage-Workflow:

Agent → get_schema(["SapNetweaver_ShortDumps_CL"])
Agent → execute_query("SapNetweaver_ShortDumps_CL | where serverTimestamp_t > ago(4h) | where SID_s == 'CHA' | take 100")
Agent → analyze_results(results, "short_dumps", context="SID=CHA, last 4h")

Vollständig automatisierte RCA:

Agent → run_full_rca(sid="CHA", time_range_hours=4, issue_description="Multiple batch job failures")
← Returns complete 8-step RCA report

Registrierte Tabellen

Derzeit registriert (1 von 7):

Hinzufügen eines neuen Tabellenschemas

1. Stellen Sie die Schema-CSV (Spalten + Beschreibung) bereit – gleiches Format wie SchemaforMCP-Details.csv.

2. Fügen Sie einen neuen Eintrag in schema_registry.py hinzu, wobei Sie den vorhandenen Eintrag SapNetweaver_ShortDumps_CL als Vorlage verwenden.

3. Wenn die Tabelle domänenspezifische Analyselogik benötigt, fügen Sie eine _analyze_<type>()-Funktion zu tools/analyze_results.py hinzu.

4. Fügen Sie eine KQL-Vorlage zu _KQL_TEMPLATES in tools/rca_orchestrator.py hinzu.

5. Starten Sie den Server neu – keine weiteren Änderungen erforderlich.

Sicherheitshinweise

• execute_query blockiert alle KQL-Verwaltungsbefehle (.ingest, .drop, .set usw.)

• run_full_rca verwendet parametrisierte KQL-Vorlagen – SID-Werte werden vor der Substitution validiert

• Alle Anmeldeinformationen werden aus Umgebungsvariablen geladen – keine Geheimnisse im Code

• Verwenden Sie auf Azure Managed Identity; speichern Sie AZURE_CLIENT_SECRET nicht in der App Service-Konfiguration

⚠ Offene Fragen (Aktion erforderlich)

Bevor der Server eine Verbindung zu Ihrem Arbeitsbereich herstellen kann, müssen Sie Folgendes bereitstellen: