Afrikas sprechende Airtime MCP

Dieses Projekt implementiert einen Model Context Protocol (MCP)-Server zur Verwaltung von Gesprächsguthabentransaktionen mithilfe der Africa's Talking API . Es bietet eine Reihe von Tools zum Abrufen des Kontostands, Senden von Gesprächsguthaben, Anzeigen aktueller Aufladungen, Summieren der Beträge aktueller Aufladungen und Zählen der Aufladungen für eine bestimmte Telefonnummer. Die Anwendung nutzt SQLite zur Speicherung von Transaktionsdaten und unterstützt afrikanische Länder, die vom Africa's Talking Airtime Service unterstützt werden, mit der korrekten Formatierung von Telefonnummern.

Beschreibung

Der Africa's Talking Airtime MCP-Server ist in die Africa's Talking Airtime API integriert, um die Übertragung von Gesprächsguthaben zu erleichtern. Zu den wichtigsten Funktionen gehören:

Senden von Sendezeit an bestimmte Telefonnummern.
Speichern von Transaktionsdetails in einer SQLite-Datenbank.
Abrufen und Zusammenfassen des Transaktionsverlaufs.
Überprüfen des Kontostands bei Africa's Talking.

Die Anwendung unterstützt die Länder, in denen der afrikanische Talking Airtime-Dienst unterstützt wird.

Installation

Voraussetzungen

Python 3.10 oder höher
UV installieren

curl -LsSf https://astral.sh/uv/install.sh | sh

Führen Sie die folgenden Schritte aus, um das Projekt lokal einzurichten und auszuführen:

Klonen Sie das Repository:

git clone https://github.com/nasoma/africastalking-airtime-mcp.git
cd africastalking-airtime-mcp

Richten Sie die virtuelle Umgebung ein und installieren Sie Abhängigkeiten, indem Sie Folgendes ausführen:

uv sync 

Sie können loslegen!

Verwendung mit KI-Tools

Mit Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "Airtime Server": {
      "command": "{{PATH_TO_UV}}", // Run `which uv` and place the output here
      "args": [
        "--directory",
        "{{PATH_TO_PROJECT}}", // cd into the repo, run `pwd` and enter the output here
        "run",
        "main.py"
      ],
      "env": {
        "username": "your_africastalking_username",
        "api_key": "your_africastalking_api_key",
        "country":"your_country", # e.g kenya, uganda, dr congo, rwanda, south africa
        "currency_code":"currency-code"  # e.g. KES, UGX, NGN
      }
    }
  }
}

Mit Gans

Goose ist eine gute Option, wenn Sie Ihr bevorzugtes LLM verwenden und einen API-Schlüssel angeben möchten.

Installieren Sie Goosee.
Öffnen Sie das Einstellungsfenster und fügen Sie eine benutzerdefinierte Erweiterung (MCP-Server) hinzu.
Geben Sie Ihrer Erweiterung einen Namen. Der Typ ist STDIO.
Fügen Sie den Befehl hinzu. Änderungen speichern.
Fügen Sie Ihre Umgebungsvariablen hinzu: username , api_key , currency_code und country .
Änderungen speichern.

Werkzeugbeschreibungen

Das MCP bietet die folgenden Tools zur Verwaltung von Sendezeittransaktionen:

check_balance :
- Beschreibung : Ruft das aktuelle Sendezeitguthaben für Ihr Africa's Talking-Konto ab.
- Verwendung : check_balance()
- Ausgabe : Gibt den Kontostand zurück (z. B. „Kontostand: KES 1234,00“) oder eine Fehlermeldung, wenn der Kontostand nicht abgerufen werden kann.
Ladezeit :
- Beschreibung : Sendet Sendezeit an eine angegebene Telefonnummer und speichert die Transaktion in der Datenbank.
- Parameter :
  - phone_number : Die Telefonnummer des Empfängers (z. B. „0712345678“ oder „+254712345678“).
  - amount : Die zu sendende Sendezeit (z. B. 100).
  - currency_code : Der Währungscode (z. B. „KES“).
- Verwendung : load_airtime("0712345678", 100.00, "KES")
- Ausgabe : Bestätigt den Erfolg (z. B. „100,00 KES Sendezeit erfolgreich an +254712345678 gesendet“) oder meldet einen Fehler.
get_last_topups :
- Beschreibung : Ruft die letzten N Aufladetransaktionen für Sendeguthaben aus der Datenbank ab.
- Parameter :
  - limit : Anzahl der abzurufenden Transaktionen (Standard: 3).
- Verwendung : get_last_topups(3)
- Ausgabe : Listet die letzten Transaktionen auf (z. B. „Letzte 3 Aufladetransaktionen: …“) oder zeigt an, dass keine Transaktionen gefunden wurden.
Summe der letzten n Aufladungen :
- Beschreibung : Berechnet den Gesamtbetrag der letzten N erfolgreichen Aufladungen und stellt sicher, dass sie dieselbe Währung verwenden.
- Parameter :
  - n : Anzahl der zu summierenden Transaktionen (Standard: 3).
- Verwendung : sum_last_n_topups(3)
- Ausgabe : Gibt die Summe zurück (z. B. „Summe der letzten 3 erfolgreichen Aufladungen: 300,00 KES“) oder einen Fehler, wenn die Währungen unterschiedlich sind.
Aufladungen nach Anzahl zählen :
- Beschreibung : Zählt die Anzahl der erfolgreichen Aufladungen einer bestimmten Telefonnummer.
- Parameter :
  - phone_number : Die abzufragende Telefonnummer (z. B. „0712345678“).
- Verwendung : count_topups_by_number("0712345678")
- Ausgabe : Gibt die Anzahl (z. B. „Anzahl der erfolgreichen Aufladungen auf +254712345678: 5“) oder einen Fehler zurück.

Beispielaufforderungen

Im Folgenden finden Sie Beispielfragen oder -befehle, die Benutzer der KI stellen können, um mit dem Africa's Talking Airtime MCP zu interagieren, basierend auf den verfügbaren Tools:

Kontostand prüfen

Wie hoch ist mein Kontostand bei Africa's Talking?
Können Sie mir den aktuellen Kontostand anzeigen?
Überprüfen Sie mein Sendezeitguthaben.

Sendezeit senden

Senden Sie 100 KES Sendezeit an 0712345678.
Laden Sie mein 0712345678 mit 60 auf.
Laden Sie 50 NGN auf +2348012345678.
Können Sie 200 UGX auf 0755123456 aufladen?

Aktuelle Aufladungen anzeigen

Zeigen Sie mir die letzten 3 Airtime-Transaktionen.
Was sind meine letzten Aufladungen?
Listen Sie die letzten 5 Aufladungen Ihres Gesprächsguthabens auf.

Summe der letzten Aufladungen

Wie hoch ist der Gesamtbetrag meiner letzten 3 Aufladungen?
Addieren Sie die Beträge meiner letzten 4 Sendezeittransaktionen.
Wie viel habe ich bei meinen letzten 5 Aufladungen gesendet?

Aufladungen nach Telefonnummer zählen

Wie oft habe ich 0712345678 aufgeladen?
Zählen Sie die Aufladungen bis +254712345678.
Sagen Sie mir, wie viele erfolgreiche Aufladungen auf 0755123456 erfolgt sind.

Hinweise

Stellen Sie sicher, dass Ihr Africa's Talking-Konto ausreichend gedeckt ist, um Sendezeit zu senden.
Telefonnummern werden automatisch basierend auf der im Client oder in claude_desktop_config.json festgelegten country formatiert.
Die SQLite-Datenbank ( airtime_transactions.db ) wird bei der Initialisierung im Projektverzeichnis erstellt.
Funktioniert am besten mit Modellen, die Tool Calling unterstützen, z. B. Claude 3.7 Sonnet . Wenn Sie auf den Preis achten, ist GPT-4.1 Nano eine gute, günstigere Option bei Verwendung mit Clients wie Goose.

🙏 Credits

Africa's Talking API Afrikas sprechende Dokumentation .

Africa's Talking Airtime MCP

Integrations