Africa's Talking Airtime MCP

Африканское говорящее эфирное время MCP

Этот проект реализует сервер Model Context Protocol (MCP) для управления транзакциями эфирного времени с использованием Africa's Talking API . Он предоставляет набор инструментов для проверки баланса счета, отправки эфирного времени, просмотра последних транзакций пополнения, суммирования сумм последних пополнений и подсчета пополнений для определенного номера телефона. Приложение использует SQLite для хранения данных транзакций и поддерживает африканские страны, поддерживаемые Africa's Talking Airtime Service, с правильным форматированием телефонных номеров.

Описание

Сервер MCP Africa's Talking Airtime интегрируется с API Africa's Talking Airtime для упрощения передачи эфирного времени. Основные функции включают:

• Отправка эфирного времени на указанные номера телефонов.
• Хранение сведений о транзакциях в базе данных SQLite.
• Извлечение и обобщение истории транзакций.
• Проверка баланса счета на Africa's Talking.

Приложение поддерживает страны, в которых поддерживается услуга Africa Talking Airtime.

Установка

Предпосылки

1. Python 3.10 или выше
2. Установить УФ

Чтобы настроить и запустить проект локально, выполните следующие действия:

1. Клонируйте репозиторий:

2. Настройте виртуальную среду и установите зависимости, выполнив:

3. Вы готовы идти!

Использование с инструментами ИИ

С Клодом Десктопом

Добавьте это в ваш claude_desktop_config.json :

С гусем

Goose — хороший вариант, если вы хотите использовать предпочитаемую вами LLM и предоставить ключ API.

• Установите Goosee.
• Откройте панель настроек и добавьте пользовательское расширение (MCP Server).
• Дайте вашему расширению имя. Тип — STDIO.
• Добавьте команду. Сохраните изменения.
• Добавьте переменные среды: username , api_key , currency_code и country .
• Сохраните изменения.

Описания инструментов

MCP предоставляет следующие инструменты для управления транзакциями эфирного времени:

1. проверка_баланса :
   • Описание : Возвращает текущий баланс эфирного времени для вашего аккаунта Africa's Talking.
   • Использование : check_balance()
   • Вывод : Возвращает остаток на счете (например, «Остаток на счете: KES 1234.00») или сообщение об ошибке, если остаток не может быть получен.
2. load_airtime :
   • Описание : Отправляет эфирное время на указанный номер телефона и сохраняет транзакцию в базе данных.
   • Параметры :
     • phone_number : номер телефона получателя (например, «0712345678» или «+254712345678»).
     • amount : количество отправленного эфирного времени (например, 100).
     • currency_code : Код валюты (например, «KES»).
   • Использование : load_airtime("0712345678", 100.00, "KES")
   • Вывод : подтверждение успеха (например, «Успешно отправлено 100,00 KES на номер +254712345678») или сообщение об ошибке.
3. get_last_topups :
   • Описание : Извлекает последние N транзакций пополнения счета из базы данных.
   • Параметры :
     • limit : количество транзакций для извлечения (по умолчанию: 3).
   • Использование : get_last_topups(3)
   • Вывод : список последних транзакций (например, «Последние 3 транзакции пополнения: ...») или указание на отсутствие транзакций.
4. сумма_последних_n_пополнений :
   • Описание : Рассчитывает общую сумму последних N успешных пополнений, гарантируя, что они используют одну и ту же валюту.
   • Параметры :
     • n : Количество транзакций для суммирования (по умолчанию: 3).
   • Использование : sum_last_n_topups(3)
   • Вывод : Возвращает сумму (например, «Сумма последних 3 успешных пополнений: KES 300.00») или ошибку, если валюты различаются.
5. count_topups_by_number :
   • Описание : Подсчитывает количество успешных пополнений счета определенного номера телефона.
   • Параметры :
     • phone_number : номер телефона для запроса (например, «0712345678»).
   • Использование : count_topups_by_number("0712345678")
   • Вывод : Возвращает количество (например, «Количество успешных пополнений счета +254712345678: 5») или ошибку.

Примеры подсказок

Ниже приведены примеры вопросов или команд, которые пользователи могут задать ИИ для взаимодействия с MCP африканского Talking Airtime, на основе доступных инструментов:

Проверить баланс счета

• Каков баланс моего счета Africa's Talking?
• Можете ли вы показать мне текущий баланс?
• Проверьте мой баланс эфирного времени.

Отправить эфирное время

• Отправьте 100 KES эфирного времени на номер 0712345678.
• Пополните мой счет 0712345678 на 60.
• Пополните счет на 50 NGN на номер +2348012345678.
• Можете ли вы пополнить счет на 200 UGX на номер 0755123456?

Просмотреть последние пополнения

• Покажите мне последние 3 транзакции эфирного времени.
• Каковы мои последние пополнения?
• Перечислите последние 5 пополнений счета.

Сумма последних пополнений

• Какова общая сумма моих последних трех пополнений?
• Сложите суммы моих последних 4 транзакций по эфирному времени.
• Какую сумму я отправил за последние 5 пополнений?

Подсчет пополнений по номеру телефона

• Сколько раз я пополнял счет 0712345678?
• Учитывайте пополнения на счете +254712345678.
• Скажите, сколько успешных пополнений было совершено на номер 0755123456?

Примечания

• Убедитесь, что на вашем счете Africa's Talking достаточно средств для отправки эфирного времени.
• Номера телефонов автоматически форматируются на основе переменной country , установленной в клиенте или в claude_desktop_config.json .
• База данных SQLite ( airtime_transactions.db ) создается в каталоге проекта при инициализации.
• Лучше всего работает с моделями, которые поддерживают вызов инструментов, например, Claude 3.7 Sonnet . Если вы заботитесь о цене GPT-4.1 Nano — хороший и более дешевый вариант при использовании с такими клиентами, как Goose.

🙏 Кредиты

• API говорящей Африки Документация говорящей Африки .