Tiempo de emisión parlante de África MCP

Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) para gestionar transacciones de saldo mediante la API de Africa's Talking . Proporciona un conjunto de herramientas para consultar el saldo de la cuenta, enviar saldo, ver recargas recientes, sumar los importes de las recargas recientes y contabilizar las recargas de un número de teléfono específico. La aplicación utiliza SQLite para almacenar los datos de las transacciones y es compatible con los países africanos que utilizan el servicio Africa's Talking Airtime con el formato correcto de los números de teléfono.

Descripción

El servidor MCP de Africa's Talking Airtime se integra con la API de Africa's Talking Airtime para facilitar las transferencias de tiempo aire. Sus principales características incluyen:

• Envío de tiempo aire a números de teléfono específicos.

• Almacenar detalles de transacciones en una base de datos SQLite.

• Recuperar y resumir el historial de transacciones.

• Consultar el saldo de la cuenta en Africa's Talking.

La aplicación es compatible con los países donde se admite el servicio Africa's Talking Airtime.

Related MCP server: mpesa-mcp

Instalación

Instalación mediante herrería

Para instalar automáticamente el servidor Africa's Talking Airtime para Claude Desktop a través de Smithery :

npx -y @smithery/cli install @nasoma/africastalking-airtime-mcp --client claude

Prerrequisitos

1. Python 3.10 o superior

2. Instalar uv

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

Siga estos pasos para configurar y ejecutar el proyecto localmente:

1. Clonar el repositorio:

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

2. Configure el entorno virtual e instale las dependencias ejecutando:

uv sync 

3. ¡Estás listo para empezar!

Uso de herramientas de IA

Con Claude Desktop

Agregue esto a su claude_desktop_config.json :

{
  "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
      }
    }
  }
}

Con ganso

Goose es una buena opción si desea utilizar su LLM preferido y proporcionar una clave API.

• Instalar Goose.

• Abra el panel de configuración y agregue una extensión personalizada (Servidor MCP).

• Dale un nombre a tu extensión. El tipo es STDIO.

• Añade el comando. Guarda los cambios.

• Agregue sus variables de entorno: username , api_key , currency_code y country .

• Guardar cambios.

Descripciones de herramientas

El MCP proporciona las siguientes herramientas para gestionar las transacciones de tiempo aire:

1. comprobar_saldo :

   • Descripción : Recupera el saldo de tiempo de aire actual de tu cuenta de Africa's Talking.

   • Uso : check_balance()

   • Salida : Devuelve el saldo de la cuenta (por ejemplo, "Saldo de la cuenta: KES 1234,00") o un mensaje de error si no se puede obtener el saldo.

2. tiempo_de_aire_de_carga :

   • Descripción : Envía tiempo aire a un número de teléfono específico y guarda la transacción en la base de datos.

   • Parámetros :

     • phone_number : El número de teléfono del destinatario (por ejemplo, "0712345678" o "+254712345678").

     • amount : la cantidad de tiempo aire a enviar (por ejemplo, 100).

     • currency_code : El código de moneda (por ejemplo, "KES").

   • Uso : load_airtime("0712345678", 100.00, "KES")

   • Salida : Confirma el éxito (por ejemplo, "Se envió exitosamente KES 100.00 en tiempo aire al +254712345678") o informa un error.

3. obtener_últimas_recargas :

   • Descripción : Recupera las últimas N transacciones de recarga de tiempo aire de la base de datos.

   • Parámetros :

     • limit : Número de transacciones a recuperar (predeterminado: 3).

   • Uso : get_last_topups(3)

   • Salida : enumera las transacciones recientes (por ejemplo, "Últimas 3 transacciones de recarga: ...") o indica que no se encontraron transacciones.

4. suma_últimas_n_recargas :

   • Descripción : Calcula el importe total de las últimas N recargas exitosas, asegurándose de que utilicen la misma moneda.

   • Parámetros :

     • n : Número de transacciones a sumar (predeterminado: 3).

   • Uso : sum_last_n_topups(3)

   • Salida : Devuelve la suma (por ejemplo, "Suma de las últimas 3 recargas exitosas: KES 300,00") o un error si las monedas difieren.

5. contar_recargas_por_número :

   • Descripción : Cuenta el número de recargas exitosas a un número de teléfono específico.

   • Parámetros :

     • phone_number : El número de teléfono a consultar (por ejemplo, "0712345678").

   • Uso : count_topups_by_number("0712345678")

   • Salida : Devuelve el recuento (por ejemplo, "Número de recargas exitosas al +254712345678: 5") o un error.

Ejemplos de indicaciones

Las siguientes son preguntas de ejemplo o comandos que los usuarios pueden pedirle a la IA para interactuar con el MCP de Africa's Talking Airtime, según las herramientas disponibles:

Consultar el saldo de la cuenta

• ¿Cuál es el saldo de mi cuenta de Africa's Talking?

• ¿Puedes mostrarme el saldo actual?

• Consultar mi saldo de tiempo aire.

Enviar tiempo aire

• Envíe 100 KES en tiempo aire al 0712345678.

• Recargue mi 0712345678 con 60.

• Cargue 50 NGN al +2348012345678.

• ¿Puedes recargar 200 UGX al 0755123456?

Ver recargas recientes

• Muéstrame las últimas 3 transacciones de tiempo aire.

• ¿Cuales son mis recargas más recientes?

• Enumere las últimas 5 recargas de tiempo aire.

Suma de recargas recientes

• ¿Cual es el total de mis últimas 3 recargas?

• Sumar los importes de mis últimas 4 transacciones de tiempo aire.

• ¿Cuánto he enviado en mis últimas 5 recargas?

Contar recargas por número de teléfono

• ¿Cuantas veces he recargado el 0712345678?

• Cuente las recargas al +254712345678.

• Dime cuántas recargas exitosas se realizaron al 0755123456.

Notas

• Asegúrese de que su cuenta de Africa's Talking tenga fondos para enviar tiempo de emisión.

• Los números de teléfono se formatean automáticamente según la variable country establecida en el cliente o en claude_desktop_config.json .

• La base de datos SQLite ( airtime_transactions.db ) se crea en el directorio del proyecto durante la inicialización.

• Funciona mejor con modelos compatibles con la función de llamada de herramientas, por ejemplo, Claude 3.7 Sonnet . Si le preocupa el precio, GPT-4.1 Nano es una buena opción, más económica, para clientes como Goose.

🙏 Créditos

• API de África Hablante Documentación de África Hablante .