Twilio MCP Server

Twilio MCP Monorepo

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

Was ist MCP?

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

Pakete

Dieses Monorepo enthält zwei Hauptpakete:

• mcp – MCP-Server für die gesamte öffentliche API von Twilio
• openapi-mcp-server – Ein MCP-Server, der die angegebene OpenAPI-Spezifikation bereitstellt

Jedes Paket verfügt über eine eigene ausführliche README mit detaillierter Dokumentation:

• MCP-Paketdokumentation
• OpenAPI-MCP-Server-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"
      ]
    }
  }
}

Besuchen Sie die Twilio API Keys-Dokumentation, um zu erfahren, wie Sie Ihren API-Schlüssel und das Secret finden/erstellen.

Sicherheitsempfehlungen

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

Grundlegende Konfigurationsoptionen

Beide Pakete akzeptieren Konfigurationsparameter. Hier ein kurzer Überblick:

• MCP-Server: Verwenden Sie --services und --tags, um zu filtern, welche APIs bereitgestellt werden
• 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: Laden Sie aufgrund von LLM-Kontextlimits bestimmte APIs mit --services oder --tags
• Authentifizierungsprobleme: Überprüfen Sie das Format und die Berechtigungen Ihrer Twilio-API-Anmeldeinformationen
• API-Versionierung: Stellen Sie sicher, dass Sie die für Ihre Anforderungen korrekte API-Version (v1, v2, v3) verwenden

Detaillierte Anleitungen zur Fehlerbehebung finden Sie in der paketspezifischen Dokumentation.

Mitwirken

Beiträge sind willkommen! Bitte reichen Sie gerne einen Pull Request ein.

Lizenz

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