Skip to main content
Glama
kostikpenzin

mcp-iva-mcu

by kostikpenzin

MCP-Server für IVA MCU

npm version npm downloads license Node.js TypeScript GitHub stars GitHub issues

42 Tools · 391 REST-Aktionen · 368 API-Endpunkte · 17 WebSocket-Kanäle

MCP-Server für die Videokonferenz-Plattform IVA MCU. Kapselt die Clients API (v2.28.12), die Integration API (v1.28.12) und die Bot API (v1.28.12) in 42 Tools, die Ihr KI-Agent direkt aufrufen kann.

Installation · Konfiguration · Tools · Verwendung · Entwicklung

Sprachen: Englisch · Русский


Kompatible API-Versionen

API

Version

Basispfad

Authentifizierung

Endpunkte

IVA Clients API

2.28.12

/api/rest

Session-Header oder JWT-Bearer

310

IVA System Integration API

1.28.12

/api/rest/integration

Bearer-Token

54

IVA Chat Bot API

1.28.12

/api/rest/bot

X-Iva-Bot-Api-Token-Header

4

OpenAPI-Spezifikationen für diese exakten Versionen finden Sie in specs/ (nur im Quell-Repository).

Related MCP server: Thenvoi MCP Server

Installation

Voraussetzungen

  • Node.js 18+

  • IVA MCU-Server-URL (z. B. https://your-iva-server.ru)

  • Mindestens ein Authentifizierungstoken (siehe Umgebungsvariablen)

Umgebungsvariablen

Variable

Erforderlich

Beschreibung

IVA_BASE_URL

Ja

IVA MCU-Server-URL

IVA_SESSION_TOKEN

Clients API

Session-UUID

IVA_JWT_TOKEN

Clients API

JWT-Token (Alternative zur Session)

IVA_INTEGRATION_TOKEN

Integration API

Bearer-Token

IVA_BOT_TOKEN

Bot API

Bot-API-Token

Setzen Sie mindestens ein Token pro API, die Sie verwenden möchten.

MCP-Client-Konfiguration

Claude Desktop

Fügen Sie Folgendes zu claude_desktop_config.json hinzu:

npx (empfohlen):

{
  "mcpServers": {
    "iva-mcu": {
      "command": "npx",
      "args": ["-y", "mcp-iva-mcu"],
      "env": {
        "IVA_BASE_URL": "https://your-iva-server.ru",
        "IVA_SESSION_TOKEN": "your-session-uuid",
        "IVA_INTEGRATION_TOKEN": "your-integration-token",
        "IVA_BOT_TOKEN": "your-bot-token"
      }
    }
  }
}

Windows — verwenden Sie cmd /c:

{
  "mcpServers": {
    "iva-mcu": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-iva-mcu"],
      "env": {
        "IVA_BASE_URL": "https://your-iva-server.ru",
        "IVA_SESSION_TOKEN": "your-session-uuid",
        "IVA_INTEGRATION_TOKEN": "your-integration-token",
        "IVA_BOT_TOKEN": "your-bot-token"
      }
    }
  }
}

Docker:

docker build -t mcp/iva-mcu .
{
  "mcpServers": {
    "iva-mcu": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "mcp/iva-mcu"],
      "env": {
        "IVA_BASE_URL": "https://your-iva-server.ru",
        "IVA_SESSION_TOKEN": "your-session-uuid",
        "IVA_INTEGRATION_TOKEN": "your-integration-token",
        "IVA_BOT_TOKEN": "your-bot-token"
      }
    }
  }
}

Cursor

Fügen Sie Folgendes zu .cursor/mcp.json hinzu:

{
  "mcpServers": {
    "iva-mcu": {
      "command": "npx",
      "args": ["-y", "mcp-iva-mcu"],
      "env": {
        "IVA_BASE_URL": "https://your-iva-server.ru",
        "IVA_SESSION_TOKEN": "your-session-uuid"
      }
    }
  }
}

VS Code

Fügen Sie Folgendes zu .vscode/mcp.json hinzu:

{
  "servers": {
    "iva-mcu": {
      "command": "npx",
      "args": ["-y", "mcp-iva-mcu"],
      "env": {
        "IVA_BASE_URL": "https://your-iva-server.ru",
        "IVA_SESSION_TOKEN": "your-session-uuid"
      }
    }
  }
}

Codex CLI

codex mcp add iva-mcu npx -y mcp-iva-mcu

Aus dem Quellcode

git clone https://github.com/kostikpenzin/mcp_iva_mcu.git
cd mcp_iva_mcu
npm install
npm run build
{
  "mcpServers": {
    "iva-mcu": {
      "command": "node",
      "args": ["/absolute/path/to/mcp_iva_mcu/dist/index.js"],
      "env": {
        "IVA_BASE_URL": "https://your-iva-server.ru",
        "IVA_SESSION_TOKEN": "your-session-uuid"
      }
    }
  }
}

Tool-Übersicht

Clients API — 28 Tools, 315 Aktionen

Tool

Beschreibung

Aktionen

iva_user_session

Anmeldung, Abmeldung, 2FA, Sitzungsverwaltung

10

iva_profile

Profil, Anrufweiterleitung, Passwort, Speicher, Abonnements

19

iva_contacts

Kontakte, Einladungen, Präsenzen, Tags

12

iva_interlocutors

Gesprächspartner finden, Präsenzabonnement

7

iva_devices

Geräte registrieren/abmelden

2

iva_documents

Konvertieren, Löschen, Seiten auflisten

4

iva_file_resources

Erstellen, Hochladen, Herunterladen, Scan-Status

5

iva_system

Systeminformationen, Medien, ICE-Server, Layouts

10

iva_chat

Chat-CRUD, Suche, Weiterleiten, Benachrichtigungen

13

iva_chat_participants

Teilnehmer hinzufügen, entfernen, aktualisieren

3

iva_chat_messages

Senden, Bearbeiten, Löschen, Markieren, Anhänge

14

iva_chat_call

Beitreten/Verlassen/Halten, Aufzeichnen, Bildschirmfreigabe, Transfer, DTMF

16

iva_conference

Konferenz-CRUD, Planung, Räume, Einladungen

12

iva_conference_session

Session-Lebenszyklus, Aufzeichnung, Transkription, Medien

35

iva_conference_session_groups

Gruppen erstellen/aktivieren/deaktivieren/verschieben/entfernen

7

iva_conference_media

Medieninformationen, Layout, Profil, Sprache, Aufmerksamkeit

12

iva_conference_participants

Hinzufügen/Entfernen/Stummschalten/Melden/Reaktion/DTMF/Rückruf

23

iva_conference_lobby

Beitreten/Verlassen, Genehmigen/Ablehnen

7

iva_conference_documents

Dokumente, Verzeichnisse, Präsentationssteuerung

19

iva_conference_inquiry

Umfragen: CRUD, Antworten, Start/Stopp, Export

16

iva_conference_chat

Konferenz-Chat: Senden/Bearbeiten/Moderieren/Exportieren

10

iva_conference_questionnaire

Fragebogen abrufen, Antworten speichern

2

iva_conference_presence_control

Präsenzkontrolle starten/stoppen/bestätigen

3

iva_conference_self_registration

Registrieren, E-Mail prüfen/erneut senden

3

iva_conference_statistics

Statistiken, Exporte, Aggregation (v1 + v2)

17

iva_conference_templates

Vorlagen-CRUD, Standard festlegen

6

iva_whiteboard

Bücher, Seiten, Präsentation, Export, Rückgängig

21

iva_screenshare

Web-/VNC-Bildschirmfreigabe, Fernsteuerung

7

Integration API — 11 Tools, 72 Aktionen

Tool

Beschreibung

Aktionen

iva_integration_users

Benutzer-CRUD, Blockieren/Entblockieren, kostenpflichtige Anrufe, Anmeldung

12

iva_integration_companies

Unternehmens-CRUD, Blockieren/Entblockieren, Speicher, kostenpflichtige Anrufe

11

iva_integration_groups

Gruppen-CRUD, Untergruppen, Benutzerverwaltung

8

iva_integration_conferences

Konferenz-CRUD, Teilnehmer, Vorlagen

7

iva_integration_conference_sessions

Session-CRUD, Räume, Teilnehmer, Dokumente

11

iva_integration_chats

Chat-CRUD, Teilnehmer, Anrufe, Dokumente

11

iva_integration_documents

Speicherdateien, Dokumente löschen

3

iva_integration_domains

Domäneninformationen abrufen

2

iva_integration_subscriptions

Abonnement-CRUD

5

iva_integration_profiles

Profilinformationen abrufen

1

iva_integration_resources

Datei herunterladen

1

Bot API — 2 Tools, 4 Aktionen

Tool

Beschreibung

Aktionen

iva_bot_chat

Nachricht senden, Dateien erstellen/hochladen/herunterladen

4

iva_bot_events

Chat-Ereignisse per WebSocket sammeln

Events — 1 Tool, 17 WebSocket-Kanäle

Tool

Beschreibung

iva_events

Ereignisse aus WebSocket-Kanälen sammeln (Chat, Konferenz, aktive Konferenz, Kontakt, Gruppe, Profil, System)

Verwendungsbeispiele

Jedes Tool verwendet einen action-Parameter (String-Enum), um die Operation auszuwählen.

Eine Konferenz erstellen:

Tool: iva_conference
Arguments:
  action: "create"
  conferenceData: { "name": "Team Meeting", "type": "PERIODICAL" }

Eine Chat-Nachricht senden:

Tool: iva_chat_messages
Arguments:
  action: "send"
  chatRoomId: "abc-123-def-456"
  messageData: { "text": "Hello everyone!" }

Ereignisse sammeln:

Tool: iva_events
Arguments:
  event_type: "chat"
  duration: 15

Entwicklung

npm install          # Install dependencies
npm run build        # Compile TypeScript + chmod +x
npm run dev          # Watch mode
npm start            # Run server
docker build -t mcp/iva-mcu .  # Docker image
npm publish          # Publish to npm (auto clean + build)

Projektstruktur

mcp_iva_mcu/
├── src/
│   ├── index.ts          # MCP server entry point
│   ├── config.ts         # Environment configuration
│   ├── api-client.ts     # HTTP client with auth
│   ├── ws-client.ts      # WebSocket client for events
│   ├── error.ts          # Error handling
│   ├── types.ts          # Shared types
│   └── tools/
│       ├── framework.ts  # Data-driven tool framework
│       ├── params.ts     # Reusable param schemas
│       ├── index.ts      # Tool registration (42 tools)
│       ├── clients/      # 28 Clients API tools
│       ├── integration/  # 11 Integration API tools
│       ├── bot/          # 2 Bot API tools
│       └── events.ts     # WebSocket events tool
├── specs/                # OpenAPI specifications
├── i18n/                 # Translations (README.ru.md)
├── Dockerfile            # Multi-stage Docker build
├── LICENSE
├── package.json
└── tsconfig.json

Lizenz

MIT

A
license - permissive license
Not graded
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
0dRelease cycle
3Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Enables managing AI meeting bots that can join, record, transcribe meetings, speak, send messages, and display media across platforms like Zoom, Google Meet, and Microsoft Teams.
    12
    MIT
  • A
    license
    B
    quality
    A
    maintenance
    Provides seamless integration with the Thenvoi AI platform, enabling AI agents and users to manage agent identities, create and participate in chat rooms, send messages with mentions, post execution events, and manage conversation lifecycles.
    44
    MIT

View all related MCP servers

Related MCP Connectors

  • Voice and chat for AI agents — Discord, Teams, Meet, Slack, Zoom, Telegram, WhatsApp, NC Talk, SIP

  • Create voice-agent scenarios, pull session analytics, place SIP calls, schedule meeting bots.

  • Manage SRG+ hubs, channels, content, assets, users, and workspaces from any MCP-aware AI agent.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kostikpenzin/mcp_iva_mcu'

If you have feedback or need assistance with the MCP directory API, please join our Discord server