Africa's Talking Airtime MCP

非洲的谈话广播时间 MCP

该项目实现了一个模型上下文协议 (MCP) 服务器，用于使用Africa's Talking API管理通话时间交易。它提供了一套工具，用于查询账户余额、发送通话时间、查看近期充值交易、汇总近期充值金额以及统计特定电话号码的充值次数。该应用程序使用 SQLite 存储交易数据，并支持使用 Africa's Talking 通话时间服务的非洲国家/地区，并提供正确的电话号码格式。

描述

Africa's Talking Airtime MCP 服务器与 Africa's Talking Airtime API 集成，以方便通话时间转移。主要功能包括：

• 向指定电话号码发送通话时间。
• 将交易详细信息存储在 SQLite 数据库中。
• 检索和汇总交易历史。
• 检查 Africa's Talking 上的账户余额。

该应用程序支持非洲Talking Airtime服务支持的国家。

安装

先决条件

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

按照以下步骤在本地设置并运行项目：

1. 克隆存储库：

2. 通过运行以下命令设置虚拟环境并安装依赖项：

3. 一切顺利！

与AI工具一起使用

使用 Claude Desktop

将其添加到您的claude_desktop_config.json中：

配鹅

如果您想使用您喜欢的 LLM 并提供 API 密钥， Goose是一个不错的选择。

• 安装 Goosee。
• 打开设置面板并添加自定义扩展（MCP 服务器）。
• 为您的扩展命名。类型为 STDIO。
• 添加命令。保存更改。
• 添加您的环境变量： username 、 api_key 、 currency_code和country 。
• 保存更改。

工具说明

MCP 提供以下工具来管理通话时间交易：

1. 检查余额：
   • 描述：检索您的 Africa's Talking 帐户的当前通话时间余额。
   • 用法： check_balance()
   • 输出：返回帐户余额（例如，“帐户余额：KES 1234.00”），如果无法获取余额，则返回错误消息。
2. 加载播放时间：
   • 描述：向指定的电话号码发送通话时间并将交易保存在数据库中。
   • 参数：
     • phone_number ：收件人的电话号码（例如“0712345678”或“+254712345678”）。
     • amount ：要发送的空中时间量（例如 100）。
     • currency_code ：货币代码（例如“KES”）。
   • 用法： load_airtime("0712345678", 100.00, "KES")
   • 输出：确认成功（例如，“已成功向 +254712345678 发送 KES 100.00 通话时间”）或报告错误。
3. 获取上次充值次数：
   • 描述：从数据库中检索最近的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”）或错误。

示例提示

以下是用户可以根据可用工具向 AI 提出的示例问题或命令，以便与非洲的 Talking Airtime MCP 进行交互：

检查账户余额

• 我的 Africa's Talking 账户余额是多少？
• 你能告诉我当前余额吗？
• 检查我的通话时间余额。

发送通话时间

• 向 0712345678 发送 100 KES 通话时间。
• 给我的 0712345678 充值 60。
• 充值 50 奈拉至 +2348012345678。
• 您能向 0755123456 充值 200 UGX 吗？

查看近期充值

• 显示最近 3 次通话时间交易。
• 我最近充值了哪些金额？
• 列出最近 5 次通话时间充值。

近期充值总额

• 我最近 3 次充值的总金额是多少？
• 将我最近 4 次通话时间交易的金额加起来。
• 我最近 5 次充值一共汇了多少钱？

按电话号码计算充值次数

• 我给0712345678充值过几次？
• 计算 +254712345678 的充值金额。
• 请告诉我有多少次成功充值到 0755123456。

笔记

• 确保您的 Africa's Talking 帐户有足够的资金来发送通话时间。
• 电话号码根据客户端或claude_desktop_config.json中设置的country变量自动格式化。
• 初始化时，在项目目录中创建 SQLite 数据库（ airtime_transactions.db ）。
• 最适合支持工具调用的模型，例如Claude 3.7 Sonnet 。如果您注重价格， GPT-4.1 Nano与 Goose 等客户端一起使用时是一个不错的、更便宜的选择。

🙏 致谢

• 非洲的谈话 API非洲的谈话文档。