Wave Server MCP
Provides tools to interact with an Android device, including reading SMS and notifications, capturing the screen, analyzing UI hierarchy, launching apps, checking device status, and waking the device.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
🐧 Wave Server MCP
Serveur MCP (Model Context Protocol) pour Android permettant de connecter vos agents IA sur ordinateur (Claude Desktop, Cursor, Antigravity, ChatGPT) à Wave Mobile Money via requêtes USSD directes et sans fil.
Intègre nativement la posture et le skill de Family Officer pour protéger votre argent, sanctuariser l'épargne d'urgence et arbitrer chaque transfert.
🎯 Contexte & Objectif
Les modèles d'IA sur ordinateur (Claude Desktop, Cursor, Antigravity IDE, agents locaux) ne disposent d'aucun accès direct aux cartes SIM ni aux réseaux télécoms pour exécuter des requêtes USSD Mobile Money.
Wave Server MCP fait le pont sans fil entre votre PC et votre smartphone :
Sur votre PC : Vous échangez en langage naturel avec votre IA (ex: « Quel est mon solde Wave ? » ou « Envoie 2 000 FCFA à maman »).
Sur votre téléphone Android : Ce serveur MCP tourne dans Termux et écoute en Wi-Fi local.
Exécution directe : Le téléphone déclenche instantanément les requêtes USSD officielles (
*9113#), lit les SMS et renvoie le résultat certifié à l'IA.
┌────────────────────────────────────────────────────────┐
│ Interface IA sur Ordinateur (PC / Mac) │
│ (Claude Desktop, Cursor, Antigravity IDE) │
└───────────────────────────┬────────────────────────────┘
│ Protocole MCP (JSON-RPC 2.0)
│ Wi-Fi local / Hotspot (Port 8765)
┌───────────────────────────▼────────────────────────────┐
│ Serveur MCP Android (Termux en Wi-Fi) │
│ serveur_mcp_telephone.py │
│ + Skill & Doctrine de Family Officer Intégrés │
└───────────────────────────┬────────────────────────────┘
│ Exécution native Android
│ (Modem Télécom & Termux:API)
┌───────────────────────────▼────────────────────────────┐
│ Requêtes USSD Wave & Système │
│ *9113# (Solde) | *9113*1*...# (Transferts) │
└────────────────────────────────────────────────────────┘Related MCP server: mcp-android
🏛️ Le Skill « Family Officer » Intégré
Wave Server MCP n'est pas un simple exécuteur aveugle : il implémente la doctrine du Family Officer (gestionnaire de patrimoine et protecteur financier personnel).
Les 4 Piliers de Protection Financière :
Sanctuaire d'Urgence Inviolable (25 000 FCFA) : L'IA veille à préserver en permanence une réserve de sécurité minimale face aux imprévus de la vie.
Arbitrage Préalable (
evaluer_impact_transfert_wave) : Avant tout transfert, le Family Officer calcule le solde résiduel, vérifie l'absence de risque pour les dépenses vitales et alerte l'utilisateur.Gestion Équilibrée de la Solidarité Familiale : Aide l'utilisateur à soutenir ses proches (dépannages, tontines) sans fragiliser son propre équilibre financier.
Bouclier Anti-Arnaque : Vérifie l'authenticité des transactions par USSD infalsifiable et prévient les pièges de faux SMS Wave.
🛠️ Outils MCP Disponibles
Nom de l'outil MCP | Description pour l'IA | Mécanisme USSD / Système |
| Consulte le solde Wave officiel en direct | Requête USSD |
| Arbitrage Family Officer : évalue l'impact du transfert sur la réserve d'urgence (25 000 FCFA) | Calcul budgétaire & modèle à 4 états |
| Envoie de l'argent Wave vers un numéro destinataire | Commande USSD |
| Récupère et filtre les SMS de transaction reçus de Wave | Lecture directe des SMS Android ( |
| Intercepte les notifications push actives de l'app Wave | Écouteur de notifications Android |
| Capture l'écran du smartphone en direct (PNG Base64) | Capture native Android ( |
| Inspecte l'arborescence UI des éléments Wave à l'écran | Dump d'accessibilité UI ( |
| Ouvre l'application Wave ( | Lanceur Intent Android |
| Remonte l'état de la batterie, du Wi-Fi et de l'appareil | Sondes matérielles Termux |
| Réveille l'écran et garde l'appareil actif | Wake-lock et keyevent Android |
📜 Prompts & Ressources MCP Intégrés
Le serveur MCP expose nativement les spécifications Prompts et Resources du Model Context Protocol :
Prompt MCP
family_officer_wave: Active instantanément la posture de protecteur financier dans votre client MCP.Ressource
wave://family-officer/doctrine: Document de référence de la charte financière et des règles de gouvernance du Family Officer.Agent Skill
skills/wave-family-officer/SKILL.md: Fichier SKILL.md autonome prêt pour Antigravity IDE, Cursor et Claude.
⚡ Exemples de Requêtes Utilisateur
💬 « Quel est mon solde Wave actuel ? »
➔ L'IA appelleconsulter_solde_wave(), interroge*9113#et répond :
« Votre solde Wave certifié est de 48 500 FCFA. »💬 « Envoie 10 000 FCFA au 0701020304 pour dépanner mon frère. »
➔ L'IA appelleevaluer_impact_transfert_wave(10000, "0701020304")et analyse :
« ⚠️ Attention : après ce transfert de 10 000 FCFA (+ 100 FCFA de frais), votre solde ne sera plus que de 38 400 FCFA. Votre réserve d'urgence de 25 000 FCFA reste préservée. Confirmez-vous l'envoi vers le 0701020304 ? »
🚀 Installation & Démarrage
1. Sur le smartphone Android (Termux)
Téléchargez et installez Termux et Termux:API depuis F-Droid.
Accordez les permissions à Termux:API (Appels / Téléphone, SMS, Notifications).
Exécutez dans Termux :
pkg update -y && pkg install -y git python termux-api
git clone https://github.com/issoufzousko-prog/wave-server-mcp.git
cd wave-server-mcp
chmod +x installer_mcp_termux.sh
./installer_mcp_termux.shLe serveur s'initialise et affiche son adresse IP (ex: http://192.168.1.50:8765).
💻 Configuration sur votre Ordinateur
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"wave-family-officer": {
"command": "python",
"args": [
"/chemin/absolu/vers/wave-server-mcp/pont_mcp_stdio_telephone.py"
],
"env": {
"IP_TELEPHONE": "192.168.1.50",
"PORT_TELEPHONE": "8765",
"WAVE_CODE_SECRET": "VOTRE_CODE_PIN"
}
}
}
}Antigravity IDE / Cursor (.agents/mcp_config.json)
{
"mcpServers": {
"wave-family-officer": {
"command": "python",
"args": [
"c:/chemin/vers/wave-server-mcp/pont_mcp_stdio_telephone.py"
],
"env": {
"IP_TELEPHONE": "192.168.1.50",
"PORT_TELEPHONE": "8765",
"WAVE_CODE_SECRET": "VOTRE_CODE_PIN"
}
}
}
}🔒 Sécurité & Confidentialité
100 % Réseau Local : Les communications s'effectuent exclusivement en Wi-Fi local sans aucun serveur tiers.
Zéro fuite de Code PIN : Votre code secret Wave n'est stocké que dans votre fichier local
.envet n'apparaît jamais en clair dans les logs ou échanges de l'IA.Zéro dépendance externe sur Android : Le serveur utilise uniquement la bibliothèque standard Python 3.
📄 Licence
Distribué sous licence MIT.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Melaya is a remote MCP server. It gives an assistant hands on your own Android phone and browser: it reads the screen through the accessibility tree, then taps, types and navigates inside the apps and sites you allow-list, with no per-app API. It also builds, schedules and runs agent pipelines across 6k+ connected tools. OAuth 2.1, nothing to install.
Read-only access to your own bank, card and brokerage accounts for Claude, ChatGPT and other AI agents: balances, transactions, spending, subscriptions, cashflow and investment holdings. It can never move money.
Personal finance, bank account, and shared memory connector for Claude, ChatGPT, Gemini Spark & more
Remote streamable-HTTP MCP server running on a single Cloudflare Worker. Your assistant gets live Airbnb, Amazon, Booking.com, Google Flights, Maps and Reddit data, social search on X, Instagram and TikTok, the Meta Ad Library, and image/video generation without any keys. Connect your own accounts to let it send WhatsApp or Telegram messages, work an IMAP inbox, manage Meta Ads campaigns and publish to X and LinkedIn. OAuth 2.1 with PKCE; stored credentials are AES-256-GCM encrypted.
Related MCP Servers
- AlicenseAqualityDmaintenanceGives PC AI agents real-world senses by connecting to an Android phone's camera, sensors, and files over local Wi-Fi without cloud relay or ADB.733 PyPI2MIT
- FlicenseBqualityBmaintenanceEnables an AI agent to control an Android phone over a private Tailscale network via accessibility UI automation, screenshots, gestures, notifications, clipboard, intents, SAF file access, and optional Termux/Shizuku shells without root or ADB.65-
- AlicenseNot gradedqualityCmaintenanceTurns an Android phone running Termux into a remotely drivable machine, letting an AI agent run shell commands, manage background jobs and tmux sessions, read and write files, install packages, and use Android device features such as battery status, screenshots, notifications, SMS and sensors. It can be reached either over stdio on the same device or over Streamable HTTP with bearer tokens and token scopes from anywhere on the local network, with a confirmation gate on destructive actions, a jailed file API and an audit log.1MIT
- AlicenseNot gradedqualityAmaintenanceLets AI agents see and use a real Android phone over Wi-Fi: read the screen, find elements by text or ID, tap, type, swipe, take screenshots and read notifications, without ADB or root.519MIT