Africa's Talking Airtime MCP

产品定位

Africa's Talking Airtime MCP 是一个用于管理话费交易的 MCP 服务，主要面向需要集成 Africa's Talking 话费服务的开发者或企业。

核心功能

1. 发送话费：向指定电话号码发送话费。
2. 交易记录存储：使用 SQLite 数据库存储交易详情。
3. 交易历史查询：检索和汇总交易历史记录。
4. 账户余额查询：查询 Africa's Talking 账户的当前余额。

适用场景

1. 话费充值服务：为终端用户提供话费充值功能。
2. 交易记录管理：管理和查询历史交易记录。
3. 账户余额监控：实时监控账户余额，确保服务正常运行。

工具列表

1. check_balance：查询 Africa's Talking 账户的当前余额。
2. load_airtime：向指定电话号码发送话费并保存交易记录。
3. get_last_topups：检索最近 N 笔充值交易记录。
4. sum_last_n_topups：计算最近 N 笔成功充值的总金额。
5. count_topups_by_number：统计向特定电话号码的成功充值次数。

常见问题解答

1. 账户余额不足：确保 Africa's Talking 账户有足够的资金用于发送话费。
2. 电话号码格式：电话号码会根据配置的国家自动格式化。
3. 数据库存储：SQLite 数据库 (airtime_transactions.db) 会在项目初始化时自动创建。

使用教程

使用依赖

1. 安装 Python 3.10 或更高版本。
2. 安装 uv：

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

安装教程

1. 克隆仓库：

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

1. 设置虚拟环境并安装依赖：

uv sync

调试方式

1. 确保环境变量 username、api_key、country 和 currency_code 已正确配置。
2. 运行服务后，可以通过工具列表中的命令进行测试，例如：

check_balance()

或

load_airtime("0712345678", 100.00, "KES")

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。