VoIPBin MCP Server

VoIPBin MCP-Server (MseeP.ai-Sicherheitsbewertungsabzeichen)

VoIPBin MCP Server

Eine Model Context Protocol (MCP)-Serverimplementierung für die VoIPBin-API, die es KI-Modellen ermöglicht, mit VoIP-Diensten zu interagieren.

Haftungsausschluss

Diese Software wird „wie besehen“ ohne jegliche ausdrückliche oder stillschweigende Gewährleistung bereitgestellt. Der Autor übernimmt keine Garantie für die Vollständigkeit, Zuverlässigkeit oder Richtigkeit dieser Software. Die Nutzung dieser Software erfolgt auf eigene Gefahr. Der Autor haftet nicht für Schäden, die durch die Nutzung dieser Software entstehen.

Überblick

Dieser MCP-Server bietet eine standardisierte Schnittstelle für KI-Modelle zur Interaktion mit den API-Diensten von VoIPBin. Er implementiert die Model Context Protocol-Spezifikation und unterstützt sowohl SSE- als auch stdio-Transporttypen.

Merkmale

Vollständige VoIPBin-API-Integration über das MCP-Protokoll
Unterstützung für die Transportmodi stdio und SSE
Umfassende Werkzeugdefinitionen mit entsprechenden Anmerkungen
Typsichere Anfrage-/Antwortbehandlung
Asynchrone HTTP-Anfragen
Richtige Fehlerbehandlung und Validierung
Docker-Unterstützung für einfache Bereitstellung

Verfügbare Tools

Anrufverwaltung

get_calls : Ruft eine Liste der Anrufe mit optionaler Filterung ab
get_call : Details zu einem bestimmten Anruf abrufen
create_call : Einen neuen Anruf erstellen
end_call : Beenden Sie einen aktiven Anruf

Agentenverwaltung

get_agents : Ruft eine Liste der Agenten ab
get_agent : Details zu einem bestimmten Agenten abrufen
update_agent_status : Aktualisieren Sie den Status eines Agenten

Kampagnenmanagement

get_campaigns : Ruft eine Liste der Kampagnen ab
get_campaign : Details einer bestimmten Kampagne abrufen
create_campaign : Eine neue Kampagne erstellen

Aufnahmeverwaltung

get_recordings : Ruft eine Liste der Anrufaufzeichnungen ab
get_recording : Details einer bestimmten Aufnahme abrufen

Warteschlangenverwaltung

get_queues : Ruft eine Liste der Anrufwarteschlangen ab
get_queue : Details einer bestimmten Warteschlange abrufen

Konferenzmanagement

get_conferences : Ruft eine Liste aktiver Konferenzen ab
create_conference : Eine neue Konferenz erstellen

Chat-Verwaltung

get_chats : Ruft eine Liste der Chat-Konversationen ab
send_chat_message : Senden Sie eine Nachricht in einer Chat-Konversation

Abrechnungsmanagement

get_billing_info : Aktuelle Rechnungsinformationen abrufen
get_billing_history : Abrufen des Abrechnungsverlaufs mit optionaler Datumsfilterung

Aufstellen

Lokales Entwicklungs-Setup

Erstellen Sie eine virtuelle Umgebung:

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

Installieren Sie Abhängigkeiten:

pip install -r requirements.txt

Erstellen Sie eine .env Datei:

cp .env.example .env

Aktualisieren Sie die .env Datei mit Ihren VoIPBin-API-Anmeldeinformationen:

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

Docker-Setup

Erstellen und Ausführen mit 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

Oder erstellen und führen Sie es direkt mit Docker aus:

# 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

Ausführen des Servers

Lokale Entwicklung

Standard-E/A-Modus

python src/main.py --transport stdio

SSE-Modus

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

Docker

Bei Verwendung von Docker läuft der Server standardmäßig im SSE-Modus. Der Container stellt Port 8000 für SSE-Verbindungen bereit.

Beispiele für die Verwendung von Tools

Erstellen eines Anrufs

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

Anrufdetails abrufen

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

Erstellen einer Konferenz

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

Senden einer Chat-Nachricht

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

Werkzeuganmerkungen

Jedes Tool enthält Anmerkungen, die Metadaten zu seinem Verhalten bereitstellen:

readOnlyHint : Gibt an, ob das Tool nur Daten liest
destructiveHint : Gibt an, ob das Tool Daten ändert oder löscht
idempotentHint : Gibt an, ob wiederholte Aufrufe die gleiche Wirkung haben wie ein einzelner Aufruf
openWorldHint : Gibt an, ob das Tool in einem Open-World-Kontext arbeitet

Fehlerbehandlung

Der Server beinhaltet eine umfassende Fehlerbehandlung:

Ungültige API-Anmeldeinformationen
Probleme mit der Netzwerkkonnektivität
Ungültige Anforderungsparameter
Ratenbegrenzung
Serverfehler

Entwicklung

Neue Tools hinzufügen

So fügen Sie ein neues Werkzeug hinzu:

Fügen Sie die Werkzeugdefinition in der Funktion list_tools() hinzu
Implementieren Sie den Tool-Handler in der Funktion voipbin_tool()
Aktualisieren Sie die Dokumentation

Testen

Führen Sie die Testsuite aus:

python -m pytest tests/

Sicherheit

API-Schlüssel werden sicher in Umgebungsvariablen gespeichert
Alle Anfragen werden authentifiziert
HTTPS wird für die API-Kommunikation erzwungen
Bei allen Anfragen wird eine Eingabevalidierung durchgeführt
Docker-Container wird als Nicht-Root-Benutzer ausgeführt
Integritätsprüfungen stellen sicher, dass der Container ordnungsgemäß läuft

Beitragen

Forken Sie das Repository
Erstellen eines Feature-Zweigs
Übernehmen Sie Ihre Änderungen
Push zum Zweig
Erstellen einer Pull-Anforderung

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

Die MIT-Lizenz ist eine freizügige Lizenz, die kurz und prägnant ist. Sie erlaubt es Benutzern, mit dem Code alles zu tun, was sie wollen, solange sie Sie als Urheber angeben und Sie nicht haftbar machen.

Was Sie mit diesem Code tun können:

Kommerziell nutzen
Ändern Sie es
Verteilen Sie es
Verwenden Sie es privat
Unterlizenzieren Sie es

Was Sie tun müssen:

Fügen Sie den ursprünglichen Copyright-Hinweis ein
Fügen Sie den Lizenztext ein
Geben Sie die Originalquelle eindeutig an
Beibehaltung der Namensnennung in allen abgeleiteten Werken

Was Sie nicht tun können:

Den Autor für Schäden haftbar machen
Entfernen oder verdecken Sie die Zuordnung
Beanspruchen Sie das Werk als Ihr eigenes

Weitere Informationen zur MIT-Lizenz finden Sie unter 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.

Ein Model Context Protocol-Server, der KI-Modellen die Interaktion mit den VoIP-Diensten von VoIPBin ermöglicht und Funktionen wie Anrufverwaltung, Agentenverwaltung, Kampagnen, Konferenzen und Chat-Funktionalität unterstützt.

VoIPBin MCP Server

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