MCP-сервер VoIPBin

Сервер VoIPBin MCP (Значок оценки безопасности MseeP.ai)

MCP-сервер VoIPBin

Реализация сервера Model Context Protocol (MCP) для API VoIPBin, позволяющая моделям ИИ взаимодействовать с сервисами VoIP.

Отказ от ответственности

Это программное обеспечение предоставляется "как есть" без каких-либо гарантий, явных или подразумеваемых. Автор не дает никаких гарантий относительно полноты, надежности или точности этого программного обеспечения. Любое использование этого программного обеспечения осуществляется на ваш собственный риск. Автор не несет ответственности за любой ущерб, возникший в результате использования этого программного обеспечения.

Обзор

Этот сервер MCP предоставляет стандартизированный интерфейс для взаимодействия моделей AI с API-сервисами VoIPBin. Он реализует спецификацию Model Context Protocol и поддерживает типы транспорта SSE и stdio.

Функции

Полная интеграция VoIPBin API через протокол MCP
Поддержка режимов транспорта stdio и SSE
Подробные определения инструментов с соответствующими аннотациями
Типобезопасная обработка запросов/ответов
Асинхронные HTTP-запросы
Правильная обработка ошибок и проверка
Поддержка Docker для простого развертывания

Доступные инструменты

Управление вызовами

get_calls : Получить список вызовов с дополнительной фильтрацией
get_call : Получить сведения о конкретном звонке
create_call : Создать новый вызов
end_call : Завершить активный вызов

Управление агентами

get_agents : Получить список агентов
get_agent : Получить сведения о конкретном агенте
update_agent_status : Обновить статус агента

Управление кампанией

get_campaigns : Получить список кампаний
get_campaign : Получить сведения о конкретной кампании
create_campaign : Создать новую кампанию

Управление записью

get_recordings : Получить список записей вызовов
get_recording : Получить сведения о конкретной записи

Управление очередями

get_queues : Получить список очередей вызовов
get_queue : Получить сведения о конкретной очереди

Управление конференциями

get_conferences : Получить список активных конференций
create_conference : Создать новую конференцию

Управление чатом

get_chats : Получить список разговоров в чате
send_chat_message : Отправить сообщение в чате

Управление выставлением счетов

get_billing_info : Получить текущую платежную информацию
get_billing_history : получение истории выставления счетов с дополнительной фильтрацией по дате

Настраивать

Настройка локального развития

Создайте виртуальную среду:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Установить зависимости:

pip install -r requirements.txt

Создайте файл .env :

cp .env.example .env

Обновите файл .env , указав свои учетные данные API VoIPBin:

VOIPBIN_API_URL=https://api.voipbin.net/v1.0
VOIPBIN_API_KEY=your-api-key-here
PORT=8000

Настройка докера

Сборка и запуск с помощью Docker Compose:

# Build and start the container
docker-compose up --build

# Run in detached mode
docker-compose up -d

# Stop the container
docker-compose down

Или выполните сборку и запуск напрямую с помощью Docker:

# Build the image
docker build -t voipbin-mcp-server .

# Run the container
docker run -d \
  -p 8000:8000 \
  -e VOIPBIN_API_KEY=your-api-key-here \
  -e VOIPBIN_API_URL=https://api.voipbin.net/v1.0 \
  voipbin-mcp-server

Запуск сервера

Местное развитие

Стандартный режим ввода-вывода

python src/main.py --transport stdio

Режим SSE

python src/main.py --transport sse --port 8000

Докер

Сервер работает в режиме SSE по умолчанию при использовании Docker. Контейнер предоставляет порт 8000 для соединений SSE.

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

Создание звонка

{
  "name": "create_call",
  "arguments": {
    "body": {
      "phone_number": "+1234567890",
      "agent_id": "agent_123",
      "campaign_id": "campaign_456"
    }
  }
}

Получение информации о вызовах

{
  "name": "get_call",
  "arguments": {
    "call_id": "call_789"
  }
}

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

{
  "name": "create_conference",
  "arguments": {
    "body": {
      "name": "Team Meeting",
      "participants": ["+1234567890", "+0987654321"]
    }
  }
}

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

{
  "name": "send_chat_message",
  "arguments": {
    "chat_id": "chat_123",
    "body": {
      "message": "Hello, how can I help you today?"
    }
  }
}

Аннотации инструментов

Каждый инструмент включает аннотации, которые предоставляют метаданные о его поведении:

readOnlyHint : Указывает, что инструмент только считывает данные
destructiveHint : Указывает, изменяет ли инструмент данные или удаляет их.
idempotentHint : указывает, имеют ли повторные вызовы тот же эффект, что и одиночный вызов
openWorldHint : указывает, работает ли инструмент в контексте открытого мира.

Обработка ошибок

Сервер включает в себя комплексную обработку ошибок:

Недействительные учетные данные API
Проблемы с сетевым подключением
Неверные параметры запроса
Ограничение скорости
Ошибки сервера

Разработка

Добавление новых инструментов

Чтобы добавить новый инструмент:

Добавьте определение инструмента в функцию list_tools()
Реализовать обработчик инструмента в функции voipbin_tool()
Обновите документацию

Тестирование

Запустите тестовый набор:

python -m pytest tests/

Безопасность

Ключи API надежно хранятся в переменных среды.
Все запросы аутентифицированы.
Для связи через API используется протокол HTTPS
Проверка входных данных выполняется для всех запросов.
Контейнер Docker запускается от имени пользователя без прав root.
Проверки работоспособности гарантируют правильную работу контейнера

Внося вклад

Форк репозитория
Создать ветку функций
Примите ваши изменения
Нажмите на ветку
Создать запрос на извлечение

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Лицензия MIT — это разрешительная лицензия, которая кратка и точна. Она позволяет людям делать с кодом все, что они хотят, пока они предоставляют вам ссылку на источник и не возлагают на вас ответственность.

Что можно сделать с этим кодом:

Использовать в коммерческих целях
Изменить его
Распространите это
Используйте его в личных целях
Сублицензируйте это

Что вам необходимо сделать:

Включите оригинальное уведомление об авторских правах
Включите текст лицензии
Укажите четкую ссылку на первоисточник.
Сохраняйте авторство в любых производных работах.

Чего нельзя делать:

Привлечь автора к ответственности за ущерб
Удалить или скрыть указание авторства
Выдавайте работу за свою собственную

Более подробную информацию о лицензии MIT можно найти на сайте choosealicense.com/licenses/mit/ .

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Сервер Model Context Protocol, который позволяет моделям ИИ взаимодействовать с VoIP-сервисами VoIPBin, поддерживая такие функции, как управление вызовами, управление агентами, кампании, конференции и чат.

MCP-сервер VoIPBin

Related MCP Servers

Voyp MCP Server
paulotaylor
A
security
A
license
A
quality
The Voyp MCP Server enables AI systems to integrate with VOYP's calling capabilities, allowing for secure telephony actions such as making calls, scheduling appointments, and tracking call statuses through the Model Context Protocol.
Last updated -
7
11
4
JavaScript
MIT License
Bluesky MCP Server
brianellin
A
security
F
license
A
quality
A Model Context Protocol server that enables AI assistants to interact with Bluesky/ATProtocol, providing authentication, timeline access, post creation, and social features like likes and follows.
Last updated -
18
10
TypeScript
Voice Call MCP Server
popcornspace
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to initiate and manage real-time voice calls using Twilio and OpenAI's voice models.
Last updated -
14
TypeScript
MIT License
Edge-TTS MCP Server
yuiseki
-
security
F
license
-
quality
A Model Context Protocol server that provides text-to-speech functionality for AI agents using Microsoft Edge's text-to-speech technology, supporting multiple voices, languages, and voice customization.
Last updated -
1
Python

View all related MCP servers