Skip to main content
Glama
kostikpenzin

mcp-iva-mcu

by kostikpenzin

IVA MCU 用 MCP サーバー

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) をラップし、 AI エージェントが直接呼び出せる 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+

  • IVA MCU サーバーの URL(例: https://your-iva-server.ru

  • 少なくとも 1 つの認証トークン(環境変数 を参照)

環境変数

変数

必須

説明

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 ごとに少なくとも 1 つのトークンを設定してください。

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

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