Skip to main content
Glama
kostikpenzin

mcp-iva-mcu

by kostikpenzin

MCP-сервер для IVA MCU

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

42 инструмента · 391 REST-действие · 368 API-эндпоинтов · 17 WebSocket-каналов

MCP-сервер для платформы видеоконференций IVA MCU. Оборачивает Clients API (v2.28.12), Integration API (v1.28.12) и Bot API (v1.28.12) в 42 инструмента, которые ваш ИИ-агент может вызывать напрямую.

Установка · Конфигурация · Инструменты · Примеры использования · Разработка

Языки: English · Русский


Совместимые версии API

API

Версия

Базовый путь

Аутентификация

Эндпоинты

IVA Clients API

2.28.12

/api/rest

Заголовок Session или JWT Bearer

310

IVA System Integration API

1.28.12

/api/rest/integration

Bearer-токен

54

IVA Chat Bot API

1.28.12

/api/rest/bot

Заголовок X-Iva-Bot-Api-Token

4

OpenAPI-спецификации для этих точных версий находятся в specs/ (только в исходном репозитории).

Related MCP server: Thenvoi MCP Server

Установка

Предварительные требования

  • Node.js 18+

  • URL-адрес сервера IVA MCU (например, https://your-iva-server.ru)

  • Как минимум один токен аутентификации (см. Переменные окружения)

Переменные окружения

Переменная

Обязательная

Описание

IVA_BASE_URL

Да

URL-адрес сервера IVA MCU

IVA_SESSION_TOKEN

Clients API

UUID сессии

IVA_JWT_TOKEN

Clients API

JWT-токен (альтернатива сессии)

IVA_INTEGRATION_TOKEN

Integration API

Bearer-токен

IVA_BOT_TOKEN

Bot API

Токен Bot API

Задайте хотя бы один токен для каждого API, который вы хотите использовать.

Конфигурация MCP-клиента

Claude Desktop

Добавьте в claude_desktop_config.json:

npx (рекомендуется):

{
  "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 — используйте 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

Добавьте в .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

Добавьте в .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

Из исходного кода

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

Обзор инструментов

Clients API — 28 инструментов, 315 действий

Инструмент

Описание

Действий

iva_user_session

Вход, выход, 2FA, управление сессиями

10

iva_profile

Профиль, переадресация вызовов, пароль, диск, подписки

19

iva_contacts

Контакты, приглашения, присутствие, теги

12

iva_interlocutors

Поиск собеседников, подписка на присутствие

7

iva_devices

Регистрация/дерегистрация устройств

2

iva_documents

Конвертация, удаление, список страниц

4

iva_file_resources

Создание, загрузка, скачивание, статус проверки

5

iva_system

Информация о системе, медиа, ICE-серверы, макеты

10

iva_chat

CRUD чатов, поиск, пересылка, уведомления

13

iva_chat_participants

Добавление, удаление, обновление участников

3

iva_chat_messages

Отправка, редактирование, удаление, избранное, вложения

14

iva_chat_call

Присоединение/выход/удержание, запись, демонстрация экрана, перевод, DTMF

16

iva_conference

CRUD конференций, расписание, комнаты, приглашения

12

iva_conference_session

Жизненный цикл сессии, запись, транскрибация, медиа

35

iva_conference_session_groups

Создание/активация/деактивация/перемещение/удаление групп

7

iva_conference_media

Информация о медиа, макет, профиль, язык, внимание

12

iva_conference_participants

Добавление/удаление/отключение звука/поднятие руки/реакция/DTMF/обратный вызов

23

iva_conference_lobby

Вход/выход, одобрение/отклонение

7

iva_conference_documents

Документы, каталоги, управление демонстрацией

19

iva_conference_inquiry

Опросы: CRUD, ответы, запуск/остановка, экспорт

16

iva_conference_chat

Чат конференции: отправка/редактирование/модерация/экспорт

10

iva_conference_questionnaire

Получение анкеты, сохранение ответов

2

iva_conference_presence_control

Запуск/остановка/подтверждение контроля присутствия

3

iva_conference_self_registration

Регистрация, проверка/повторная отправка email

3

iva_conference_statistics

Статистика, экспорт, агрегация (v1 + v2)

17

iva_conference_templates

CRUD шаблонов, установка по умолчанию

6

iva_whiteboard

Книги, страницы, демонстрация, экспорт, отмена

21

iva_screenshare

Веб/VNC демонстрация экрана, удалённое управление

7

Integration API — 11 инструментов, 72 действия

Инструмент

Описание

Действий

iva_integration_users

CRUD пользователей, блокировка/разблокировка, платные звонки, вход

12

iva_integration_companies

CRUD компаний, блокировка/разблокировка, диск, платные звонки

11

iva_integration_groups

CRUD групп, подгруппы, управление пользователями

8

iva_integration_conferences

CRUD конференций, участники, шаблоны

7

iva_integration_conference_sessions

CRUD сессий, комнаты, участники, документы

11

iva_integration_chats

CRUD чатов, участники, звонки, документы

11

iva_integration_documents

Файлы на диске, удаление документов

3

iva_integration_domains

Получение информации о домене

2

iva_integration_subscriptions

CRUD подписок

5

iva_integration_profiles

Получение информации о профиле

1

iva_integration_resources

Скачивание файла

1

Bot API — 2 инструмента, 4 действия

Инструмент

Описание

Действий

iva_bot_chat

Отправка сообщения, создание/загрузка/скачивание файлов

4

iva_bot_events

Сбор событий чата через WebSocket

События — 1 инструмент, 17 WebSocket-каналов

Инструмент

Описание

iva_events

Сбор событий из WebSocket-каналов (чат, конференция, активная конференция, контакт, группа, профиль, система)

Примеры использования

Каждый инструмент использует параметр action (строковое перечисление) для выбора операции.

Создание конференции:

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

Отправка сообщения в чат:

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

Сбор событий:

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

Разработка

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)

Структура проекта

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

Лицензия

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