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
Installation über Smithery
So installieren Sie Africa's Talking Airtime Server für Claude Desktop automatisch über Smithery :
npx -y @smithery/cli install @nasoma/africastalking-airtime-mcp --client claude
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:
- Sie können loslegen!
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 Goose.
- Ö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 über ausreichend Guthaben verfügt, 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