@calltelemetry/cucm-emulator-mcp

OpenAPI-gesteuerter Model Context Protocol (MCP)-Server für Cisco Unified Communications Manager (CUCM) Emulator.

Übersicht

@calltelemetry/cucm-emulator-mcp ist ein OpenAPI-gesteuerter MCP-Server, der KI-Assistenten und Automatisierungsagenten direkt mit Cisco CUCM Emulator-Instanzen verbindet. Er parst die OpenAPI-3.1.0-Kontraktspezifikation des Emulators, um dynamisch stark typisierte, diskrete MCP-Tools über alle 6 Kern-Telefonie-Domänen zu generieren:

1. Fixtures & Topologie: emu_seed_fixtures, emu_reset_store, emu_inspect_fixtures

2. Knoten & Cluster-Health: emu_list_nodes, emu_set_node_status (ADR 0120/0122-Failover)

3. Telefone & Registrierung: emu_list_phones, emu_set_phone_status, emu_get_phone_web

4. Anrufsimulation & Gesprächsabschnitte: emu_simulate_call, emu_call_action, emu_list_active_calls

5. CURRI / ECC-Routing-Richtlinien: emu_evaluate_curri, emu_get_curri_history

6. CDR / CMR-Puffer: emu_generate_cdrs, emu_get_cdr_history

7. Dynamische OpenAPI-Operationen: 46+ automatisch kompilierte Operationen (emu_get_summary, emu_get_topology, emu_query_sql, emu_list_inventory, emu_upsert_inventory, usw.)

Related MCP server: packet-tracer-mcp

Architektur

┌─────────────────────────────────────────────────────────────┐
│                    AI Agents / MCP Clients                  │
│                (Claude Code, Cursor, Windsurf)              │
└──────────────────────────────┬──────────────────────────────┘
                               │ JSON-RPC 2.0 (Stdio / SSE)
┌──────────────────────────────▼──────────────────────────────┐
│                  CucmEmulatorMcpServer                      │
│                                                             │
│  ┌───────────────────────┐      ┌────────────────────────┐  │
│  │     Tool Registry     │      │   OpenAPI Spec Parser  │  │
│  │ (15 Domain + Dynamic) │◄─────┤   (Dereferencer/Build) │  │
│  └───────────┬───────────┘      └────────────────────────┘  │
│              │                                              │
│  ┌───────────▼───────────────────────────────────────────┐  │
│  │             ICucmEmulatorClient Abstraction           │  │
│  └───────────┬───────────────────────────┬───────────────┘  │
└──────────────┼───────────────────────────┼──────────────────┘
               │                           │
┌──────────────▼────────────┐ ┌────────────▼──────────────────┐
│      HttpCucmClient       │ │    DirectStoreCucmClient      │
│  Live In-Guest / Container│ │  In-Memory Mock Store State   │
│ (http://127.0.0.1:8443)   │ │  (100% Offline Zero-Config)   │
└───────────────────────────┘ └───────────────────────────────┘

Installation & Schnellstart

Globale CLI

npm install -g @calltelemetry/cucm-emulator-mcp

Stdio-Server ausführen (für KI-Agenten / Claude Desktop)

cucm-emulator-mcp --transport stdio

SSE-Server ausführen

cucm-emulator-mcp --transport sse --port 3000 --host 127.0.0.1

Konfigurationsoptionen

MCP-Client-Konfiguration

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "cucm-emulator": {
      "command": "cucm-emulator-mcp",
      "args": ["--transport", "stdio", "--mock", "--seed-profile", "lab-small"]
    }
  }
}

SSE-Integration

{
  "mcpServers": {
    "cucm-emulator-sse": {
      "url": "http://127.0.0.1:3000/sse"
    }
  }
}

Verfügbare Tool-Referenz

Fixtures & Topologie

• emu_seed_fixtures: Seedet deterministische Cluster-Topologie, Knoten, Telefone, Dial-Plan-Partitionen, CSS und CURRI-Richtlinien.

• emu_reset_store: Setzt den Emulatorzustand zurück oder löscht ihn und seedet ihn erneut mit dem angegebenen Topologieprofil.

• emu_inspect_fixtures: Inspiziert und gibt eine umfassende Zusammenfassung des aktiven CUCM-Clusterzustands zurück.

Knoten & Failover

• emu_list_nodes: Listet alle CUCM-Clusterknoten (Publisher, Subscriber, TFTP) mit Rollen und RIS-Rückgabecodes auf.

• emu_set_node_status: Setzt den Knotenstatus (Online, Offline, NotFound, SearchLimitExceeded) für ADR 0120/0122-Failover-Tests.

Telefone & Registrierung

• emu_list_phones: Listet konfigurierte und registrierte Cisco-IP-Telefon-Endpunkte mit Verzeichnisnummern und MAC-Adressen auf.

• emu_set_phone_status: Aktualisiert den Telefonregistrierungsstatus (Registered, UnRegistered, Rejected, Unknown).

• emu_get_phone_web: Ruft XML-, HTML- oder JSON-Serviceability-/Status-Webantworten des Telefons ab.

Anrufsimulation & Gesprächsabschnitte

• emu_simulate_call: Simuliert einen End-to-End-Telefonanruf durch das CUCM-Dial-Plan-Routing mit RTP-Mediendaten.

• emu_call_action: Führt Mid-Call-Aktionen aus (answer, hold, resume, drop).

• emu_list_active_calls: Listet aktive, laufende Anrufsitzungen im Emulator auf.

CURRI / ECC-Routing-Richtlinien

• emu_evaluate_curri: Bewertet externe Anrufrouting-Richtlinien über CURRI / ECC und gibt Entscheidungen wie permit, deny oder divert zurück.

• emu_get_curri_history: Ruft das Protokoll vergangener CURRI-Routing-Entscheidungen ab.

CDR / CMR-Puffer

• emu_generate_cdrs: Generiert Stapel synthetischer CDR-Datensätze (normal, abgebrochen, CURRI-blockiert, Burst).

• emu_get_cdr_history: Ruft aktuelle CDR-Datensätze im strukturierten JSON- oder Roh-CSV-Exportformat ab.

Entwicklung & Verifizierung

# Typecheck
npm run typecheck

# Build TypeScript
npm run build

# Run Full Test Suite (155 Tests)
npm test

# Run with Coverage
npm run test:coverage

# Verify Packaging
npm pack --dry-run

Lizenz

MIT © Call Telemetry