Skip to main content
Glama
mcp-iva-mcu

mcp-iva-mcu

by kostikpenzin

Servidor MCP para IVA MCU

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

42 herramientas · 391 acciones REST · 368 endpoints de API · 17 canales WebSocket

Servidor MCP para la plataforma de videoconferencias IVA MCU. Envuelve Clients API (v2.28.12), Integration API (v1.28.12) y Bot API (v1.28.12) en 42 herramientas que su agente de IA puede invocar directamente.

Instalación · Configuración · Herramientas · Uso · Desarrollo

Idiomas: Inglés · Русский


Versiones de API compatibles

API

Versión

Ruta base

Autenticación

Endpoints

IVA Clients API

2.28.12

/api/rest

Cabecera Session o JWT Bearer

310

IVA System Integration API

1.28.12

/api/rest/integration

Token Bearer

54

IVA Chat Bot API

1.28.12

/api/rest/bot

Cabecera X-Iva-Bot-Api-Token

4

Las especificaciones OpenAPI para estas versiones exactas se encuentran en specs/ (solo en el repositorio fuente).

Related MCP server: Pipecat MCP Server

Instalación

Requisitos previos

  • Node.js 18+

  • URL del servidor IVA MCU (p. ej., https://your-iva-server.ru)

  • Al menos un token de autenticación (consulte Variables de entorno)

Variables de entorno

Variable

Requerida

Descripción

IVA_BASE_URL

Sí

URL del servidor IVA MCU

IVA_SESSION_TOKEN

Clients API

UUID de sesión

IVA_JWT_TOKEN

Clients API

Token JWT (alternativa a la sesión)

IVA_INTEGRATION_TOKEN

Integration API

Token Bearer

IVA_BOT_TOKEN

Bot API

Token de Bot API

Configure al menos un token por cada API que desee utilizar.

Configuración del cliente MCP

Claude Desktop

Añada a claude_desktop_config.json:

npx (recomendado):

{
  "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 — use 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

Añada a .cursor/mcp.json:

{
  "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

Añada a .vscode/mcp.json:

{
  "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

Desde el código fuente

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"
      }
    }
  }
}

Resumen de herramientas

Clients API — 28 herramientas, 315 acciones

Herramienta

Descripción

Acciones

iva_user_session

Inicio de sesión, cierre de sesión, 2FA, gestión de sesiones

10

iva_profile

Perfil, desvío de llamadas, contraseña, disco, suscripciones

19

iva_contacts

Contactos, invitaciones, presencias, etiquetas

12

iva_interlocutors

Buscar interlocutores, suscripción de presencia

7

iva_devices

Registrar/anular el registro de dispositivos

2

iva_documents

Convertir, eliminar, listar páginas

4

iva_file_resources

Crear, subir, descargar, estado de escaneo

5

iva_system

Información del sistema, medios, servidores ICE, diseños

10

iva_chat

CRUD de chat, búsqueda, reenvío, notificaciones

13

iva_chat_participants

Añadir, eliminar, actualizar participantes

3

iva_chat_messages

Enviar, editar, eliminar, destacar, adjuntos

14

iva_chat_call

Unirse/salir/retener, grabar, compartir pantalla, transferir, DTMF

16

iva_conference

CRUD de conferencias, programación, salas, invitaciones

12

iva_conference_session

Ciclo de vida de la sesión, grabación, transcripción, medios

35

iva_conference_session_groups

Crear/activar/desactivar/mover/eliminar grupos

7

iva_conference_media

Información de medios, diseño, perfil, idioma, atención

12

iva_conference_participants

Añadir/eliminar/silenciar/mano/reacción/DTMF/llamada de retorno

23

iva_conference_lobby

Unirse/salir, aprobar/rechazar

7

iva_conference_documents

Documentos, directorios, control de demostración

19

iva_conference_inquiry

Encuestas: CRUD, respuestas, iniciar/detener, exportar

16

iva_conference_chat

Chat de conferencia: enviar/editar/moderar/exportar

10

iva_conference_questionnaire

Obtener cuestionario, guardar respuestas

2

iva_conference_presence_control

Iniciar/detener/confirmar control de presencia

3

iva_conference_self_registration

Registrarse, comprobar/reenviar correo electrónico

3

iva_conference_statistics

Estadísticas, exportaciones, agregación (v1 + v2)

17

iva_conference_templates

CRUD de plantillas, establecer predeterminada

6

iva_whiteboard

Libros, páginas, demostración, exportar, deshacer

21

iva_screenshare

Compartición de pantalla Web/VNC, control remoto

7

Integration API — 11 herramientas, 72 acciones

Herramienta

Descripción

Acciones

iva_integration_users

CRUD de usuarios, bloquear/desbloquear, llamadas de pago, inicio de sesión

12

iva_integration_companies

CRUD de empresas, bloquear/desbloquear, disco, llamadas de pago

11

iva_integration_groups

CRUD de grupos, subgrupos, gestión de usuarios

8

iva_integration_conferences

CRUD de conferencias, participantes, plantillas

7

iva_integration_conference_sessions

CRUD de sesiones, salas, participantes, documentos

11

iva_integration_chats

CRUD de chats, participantes, llamadas, documentos

11

iva_integration_documents

Archivos de disco, eliminar documentos

3

iva_integration_domains

Obtener información del dominio

2

iva_integration_subscriptions

CRUD de suscripciones

5

iva_integration_profiles

Obtener información del perfil

1

iva_integration_resources

Descargar archivo

1

Bot API — 2 herramientas, 4 acciones

Herramienta

Descripción

Acciones

iva_bot_chat

Enviar mensaje, crear/subir/descargar archivos

4

iva_bot_events

Recopilar eventos de chat mediante WebSocket

—

Eventos — 1 herramienta, 17 canales WebSocket

Herramienta

Descripción

iva_events

Recopilar eventos de canales WebSocket (chat, conferencia, conferencia activa, contacto, grupo, perfil, sistema)

Ejemplos de uso

Cada herramienta utiliza un parámetro action (enumeración de cadenas) para seleccionar la operación.

Crear una conferencia:

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

Enviar un mensaje de chat:

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

Recopilar eventos:

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

Desarrollo

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)

Estructura del proyecto

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

Licencia

MIT

Available Tools

28 tools
iva_chatB

IVA chat management: create group chat, get/search/update/delete chats, forward messages, clear history, manage notifications, get P2P chat, get muted chats. Clients API v2.28.12.

Inputs: action (required), name, size, email, +17 more.

iva_chat_callC

IVA chat calls: join/leave/hold calls, start/stop recording, start/stop screen sharing, transfer calls, DTMF, media state, start outgoing call, cancel outgoing call. Clients API v2.28.12.

Inputs: action (required), confirm, callData, dtmfData, +5 more.

iva_chat_messagesC

IVA chat messages: send/edit/delete/star messages, search attachments, get messages/changes/starred, typing notification, read receipt. Clients API v2.28.12.

Inputs: action (required), size, limit, dateTo, +16 more.

iva_chat_participantsA

IVA chat participants: add and remove participants, update participant settings. Clients API v2.28.12.

Inputs: action (required), confirm, profileId, chatRoomId, +3 more.

iva_conferenceC

IVA conference management: create/get/update/delete conferences, calculate session schedule, quick start, create rooms, get participants, respond to invitations, get free resources. Clients API v2.28.12.

Inputs: action (required), limit, offset, confirm, +7 more.

iva_conference_chatC

IVA conference chat messages: send/edit/remove/moderate messages, get messages/participant-targets, export to txt, typing notification, remove all messages. Clients API v2.28.12.

Inputs: action (required), size, limit, dateTo, +13 more.

iva_conference_documentsC

IVA conference documents: create/delete/update/move/list documents and directories, document/video demonstration control (start/stop/pause/play/position), get pages/path/can-upload, public documents. Clients API v2.28.12.

Inputs: action (required), limit, offset, confirm, +10 more.

iva_conference_inquiryC

IVA conference inquiries (polls): create/find/get/delete/update inquiries, start/stop individual or all inquiries, answer/edit answers, find responders, get aggregated answers, export. Clients API v2.28.12.

Inputs: action (required), limit, offset, confirm, +7 more.

iva_conference_lobbyB

IVA conference lobby: join/leave lobby, get lobby participants, approve/reject individual or all participant requests. Clients API v2.28.12.

Inputs: action (required), confirm, profileId, conferenceSessionId.

iva_conference_mediaC

IVA conference media: get media/room info, report media state, request/revoke attention, report equipment, set layout/media-profile/broadcast-language/original-volume/screen-orientation/translation-direction. Clients API v2.28.12.

Inputs: action (required), layout, confirm, mediaProfile, +8 more.

iva_conference_participantsB

IVA conference participants: add/remove/find/get/disconnect participants, mute/unmute media, hand up/down, DTMF, reactions, audio callback, outgoing calls, layout settings, update settings, return to lobby. Clients API v2.28.12.

Inputs: action (required), limit, offset, confirm, +11 more.

iva_conference_presence_controlC

IVA conference presence control: start/stop presence control, confirm attendance. Clients API v2.28.12.

Inputs: action (required), confirm, startData, confirmData, +2 more.

iva_conference_questionnaireB

IVA conference questionnaire: get questionnaire, save questionnaire answers. Clients API v2.28.12.

Inputs: action (required), confirm, answersData, conferenceSessionId.

iva_conference_self_registrationB

IVA conference self-registration: register, check email, resend email. Clients API v2.28.12.

Inputs: action (required), confirm, emailData, registrationData, +1 more.

iva_conference_sessionB

IVA conference session management: get/find/update/delete sessions, join/leave, start/stop, timer control, recording, transcription, subtitling, media publication, invitations, public info. Clients API v2.28.12.

Inputs: action (required), limit, query, state, +17 more.

iva_conference_session_groupsC

IVA conference session groups: create/activate/deactivate/remove groups, extend duration, move participants, get groups. Clients API v2.28.12.

Inputs: action (required), confirm, moveData, extendData, +5 more.

iva_conference_statisticsC

IVA conference statistics: get session/participant statistics, participants activity, sessions statistics aggregation, export to CSV, user participation statistics. Clients API v2.28.12.

Inputs: action (required), limit, dateTo, offset, +7 more.

iva_conference_templatesA

IVA conference templates: list/create/get/delete/update templates, set template as default. Clients API v2.28.12.

Inputs: action (required), confirm, templateData, conferenceTemplateId.

iva_contactsC

IVA contacts management: get/search contacts, changes, presences, invitations, tags, invite, reject, remove, update, create note. Clients API v2.28.12.

Inputs: action (required), id, limit, dateTo, +8 more.

iva_devicesC

IVA device management: register and deregister user devices. Clients API v2.28.12.

Inputs: action (required), confirm, deviceId, profileId, +1 more.

iva_documentsC

IVA user documents: convert document, delete single/multiple, list converted pages. Clients API v2.28.12.

Inputs: action (required), limit, offset, confirm, +2 more.

iva_file_resourcesC

IVA file resources: create resource, download/upload files, get resources info, subscribe to scanning status. Clients API v2.28.12.

Inputs: action (required), confirm, scanData, resourceId, +2 more.

iva_interlocutorsC

IVA interlocutors: find by contact/ldap/profile/profileIds, find interlocutors, get available types, subscribe to presence. Clients API v2.28.12.

Inputs: action (required), userId, confirm, contactId, +3 more.

iva_profileB

IVA user profile management: get/update profile, call forwarding rules, disk utilization, notifications, subscriptions. Clients API v2.28.12. Note: password management and recovery actions are excluded for security.

Inputs: action (required), confirm, profileId, forwardingId, +4 more.

iva_screenshareB

IVA screenshare: start/stop web or VNC screen demonstration, request/respond/stop remote control, batch respond. Clients API v2.28.12.

Inputs: action (required), confirm, batchData, startData, +4 more.

iva_systemC

IVA system info: system info, media info, ICE servers, layouts, broadcast notifications, SMS approval, crash report, mail to support, client applications. Clients API v2.28.12.

Inputs: action (required), fileId, confirm, smsData, +2 more.

iva_user_sessionA

IVA user session management: logout, session info, guest login, session state, login URL. Clients API v2.28.12. Note: login and 2FA actions are excluded for security — authentication is handled automatically via IVA_LOGIN/IVA_PASSWORD environment variables.

Inputs: action (required), confirm, providerId, sessionState.

iva_whiteboardA

IVA whiteboard: start/stop demonstration, manage books and pages (add/delete/update/clear/copy/reorder), get whiteboard/books/pages, export to PNG, undo, save change, update cursor/demo state. Clients API v2.28.12.

Inputs: action (required), limit, bookId, offset, +13 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 28 tools

    Disambiguation4/5

    Tools are grouped by resource domain, so most have clearly separate purposes. The main ambiguities are between iva_documents, iva_file_resources, and iva_conference_documents, and between iva_chat and iva_conference_chat, but the descriptions clarify those boundaries.

    Naming Consistency5/5

    All 28 tools follow the same iva_<domain> snake_case pattern, making the set highly predictable. No camelCase or mixed verb styles are present, and singular/plural differences are minor.

    Tool Count2/5

    At 28 tools, the set exceeds the 25+ threshold and reads as a kitchen-sink API wrapper rather than a focused MCU toolset. Even though each tool covers a distinct area, the breadth creates a heavy navigation burden for agents.

    Completeness5/5

    The surface is very complete for the IVA platform: chats, conferences, sessions, media, lobby, statistics, templates, documents, whiteboard, contacts, profile, devices, and system operations are all covered. Excluded login/2FA/password actions are intentional security boundaries, not coverage gaps.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    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
      Not graded
      quality
      C
      maintenance
      Enables AI agents to join and actively participate in video calls, providing real-time interaction and meeting tools through an MCP server.
      573
      MIT