Dies ist ein Monorepo für den Model Context Protocol-Server, der alle Twilio-APIs verfügbar macht.

Was ist MCP?

Das Model Context Protocol (MCP) ist ein Protokoll zum Austausch von Modellkontextinformationen zwischen KI-Tools und -Diensten. Diese Implementierung ermöglicht es Ihnen, die APIs von Twilio für KI-Assistenten und andere Tools verfügbar zu machen, die das MCP-Protokoll unterstützen.

Related MCP server: Aligo SMS MCP Server

Pakete

Dieses Monorepo enthält zwei Hauptpakete:

mcp – MCP-Server für alle öffentlichen APIs von Twilio
openapi-mcp-server – Ein MCP-Server, der die angegebene OpenAPI-Spezifikation bereitstellt

Jedes Paket verfügt über eine eigene umfassende README-Datei mit detaillierter Dokumentation:

Schnellstart

Der einfachste Einstieg erfolgt mit npx:

{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": [
        "-y",
        "@twilio-alpha/mcp",
        "YOUR_ACCOUNT_SID/YOUR_API_KEY:YOUR_API_SECRET"
      ]
    }
  }
}

Informationen zum Finden/Erstellen Ihres API-Schlüssels und -Geheimnisses finden Sie in der Dokumentation zu Twilio-API-Schlüsseln .

Sicherheitsempfehlungen

Zum Schutz vor Injection-Angriffen, die nicht vertrauenswürdigen Systemen Zugriff auf Ihre Twilio-Daten ermöglichen könnten, rät das ETI-Team Nutzern von Twilio-MCP-Servern, keine Community-MCP-Server neben unseren offiziellen Servern zu installieren oder zu betreiben. Dadurch wird sichergestellt, dass nur vertrauenswürdige MCP-Server Zugriff auf Tools haben, die mit Ihrem Twilio-Konto interagieren, und das Risiko eines unbefugten Datenzugriffs verringert.

Grundlegende Konfigurationsoptionen

Beide Pakete akzeptieren Konfigurationsparameter. Hier ist eine kurze Übersicht:

MCP-Server : Verwenden Sie --services und --tags um zu filtern, welche APIs verfügbar gemacht werden sollen
OpenAPI MCP-Server : Verwenden Sie --apiPath um den Speicherort der OpenAPI-Spezifikationsdateien anzugeben

Vollständige Konfigurationsdetails finden Sie in der oben verlinkten paketspezifischen Dokumentation.

Entwicklung

# Run tests
npm test

# Run linting
npm run lint

# Fix linting issues
npm run lint:fix

Fehlerbehebung bei häufigen Problemen

Kontextgrößenbeschränkungen : Aufgrund von LLM-Kontextbeschränkungen laden Sie bestimmte APIs mit --services oder --tags
Authentifizierungsprobleme : Überprüfen Sie das Format und die Berechtigungen Ihrer Twilio-API-Anmeldeinformationen
API-Versionierung : Überprüfen Sie, ob Sie die richtige API-Version (v1, v2, v3) für Ihre Anforderungen verwenden

Ausführliche Anleitungen zur Fehlerbehebung finden Sie in der paketspezifischen Dokumentation.