Skip to main content
Glama
kostikpenzin

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: Thenvoi 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

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

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