Skip to main content
Glama
kostikpenzin

mcp-iva-mcu

by kostikpenzin

MCP Server for IVA MCU

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

42 个工具 · 391 个 REST 操作 · 368 个 API 端点 · 17 个 WebSocket 通道

用于 IVA MCU 视频会议平台的 MCP 服务器。 将 Clients API (v2.28.12)、Integration API (v1.28.12) 和 Bot API (v1.28.12) 封装为 42 个工具,你的 AI 智能体可以直接调用。

安装 · 配置 · 工具 · 使用示例 · 开发

语言: 英语 · Русский


兼容的 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+

  • IVA MCU 服务器 URL(例如 https://your-iva-server.ru

  • 至少一个认证令牌(参见环境变量

环境变量

变量

是否必需

说明

IVA_BASE_URL

IVA MCU 服务器 URL

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

注册、检查/重新发送电子邮件

3

iva_conference_statistics

统计、导出、聚合(v1 + v2)

17

iva_conference_templates

模板 CRUD、设置默认

6

iva_whiteboard

画册、页面、演示、导出、撤销

21

iva_screenshare

Web/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