Skip to main content
Glama
kostikpenzin

mcp-iva-mcu

by kostikpenzin

IVA MCU용 MCP 서버

npm 버전 npm 다운로드 라이선스 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개 도구로 래핑합니다.

설치 · MCP 클라이언트 설정 · 도구 개요 · 사용 예시 · 개발

언어: 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

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