아프리카의 토크 에어타임 MCP

이 프로젝트는 아프리카의 Talking API를 사용하여 통화량 거래를 관리하는 모델 컨텍스트 프로토콜(MCP) 서버를 구현합니다. 계좌 잔액 확인, 통화량 전송, 최근 충전 거래 내역 조회, 최근 충전 금액 합산, 그리고 특정 전화번호에 대한 충전 횟수 계산을 위한 도구 세트를 제공합니다. 이 애플리케이션은 SQLite를 사용하여 거래 데이터를 저장하고, 아프리카의 Talking Airtime Service가 지원하는 아프리카 국가들의 전화번호 형식을 지원합니다.

설명

Africa's Talking Airtime MCP 서버는 Africa's Talking Airtime API와 통합되어 통화 시간 전송을 용이하게 합니다. 주요 기능은 다음과 같습니다.

지정된 전화번호로 통화 시간을 보냅니다.
SQLite 데이터베이스에 거래 세부 정보를 저장합니다.
거래 내역을 검색하고 요약합니다.
Africa's Talking에서 계좌 잔액을 확인합니다.

이 애플리케이션은 Africa's Talking Airtime 서비스가 지원되는 국가를 지원합니다.

설치

필수 조건

Python 3.10 이상
uv 설치

지엑스피1

프로젝트를 로컬로 설정하고 실행하려면 다음 단계를 따르세요.

저장소를 복제합니다.

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

다음을 실행하여 가상 환경을 설정하고 종속성을 설치합니다.

uv sync 

이제 시작입니다!

AI 도구와 함께 사용

Claude Desktop과 함께

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

거위와 함께

원하는 LLM을 사용하고 API 키를 제공하려는 경우 Goose 는 좋은 옵션입니다.

구시를 설치하세요.
설정 패널을 열고 사용자 지정 확장 프로그램(MCP 서버)을 추가합니다.
확장 프로그램의 이름을 지정하세요. 유형은 STDIO입니다.
명령을 추가하고 변경 사항을 저장하세요.
환경 변수를 추가합니다: username , api_key , currency_code , country .
변경 사항을 저장합니다.

도구 설명

MCP는 통화 시간 거래를 관리하기 위한 다음과 같은 도구를 제공합니다.

체크_잔액 :
- 설명 : Africa's Talking 계정의 현재 통화 잔액을 검색합니다.
- 사용법 : check_balance()
- 출력 : 계좌 잔액(예: "계좌 잔액: KES 1234.00")을 반환하거나 잔액을 가져올 수 없는 경우 오류 메시지를 반환합니다.
로드_에어타임 :
- 설명 : 지정된 전화번호로 통화 시간을 보내고 데이터베이스에 거래를 저장합니다.
- 매개변수 :
  - phone_number : 수신자의 전화번호(예: "0712345678" 또는 "+254712345678").
  - amount : 보낼 통화 시간의 양(예: 100)
  - currency_code : 통화 코드(예: "KES")입니다.
- 사용법 : load_airtime("0712345678", 100.00, "KES")
- 출력 : 성공 확인(예: "+254712345678로 KES 100.00 통화 시간을 성공적으로 보냈습니다") 또는 오류를 보고합니다.
마지막_토핑_받기 :
- 설명 : 데이터베이스에서 마지막 N 통화료 충전 거래를 검색합니다.
- 매개변수 :
  - limit : 검색할 거래 수(기본값: 3).
- 사용법 : get_last_topups(3)
- 출력 : 최근 거래 내역을 나열합니다(예: "마지막 3개 충전 거래: ...") 또는 거래 내역이 없음을 나타냅니다.
마지막_n_충전_합계 :
- 설명 : 마지막으로 성공한 N 충전 총액을 계산하여 동일한 통화를 사용하는지 확인합니다.
- 매개변수 :
  - n : 합산할 거래 수(기본값: 3).
- 사용법 : sum_last_n_topups(3)
- 출력 : 합계(예: "마지막 3개 성공적인 충전 합계: KES 300.00")를 반환하거나 통화가 다르면 오류를 반환합니다.
개수별_충전_카운트 :
- 설명 : 특정 전화번호에 대한 성공적인 충전 횟수를 센다.
- 매개변수 :
  - phone_number : 쿼리할 전화번호(예: "0712345678").
- 사용법 : count_topups_by_number("0712345678")
- 출력 : 카운트(예: "성공적인 충전 횟수 +254712345678: 5") 또는 오류를 반환합니다.

예시 프롬프트

다음은 사용 가능한 도구를 기반으로 사용자가 AI에게 Africa's Talking Airtime MCP와 상호 작용하도록 요청할 수 있는 질문이나 명령의 예입니다.

계좌 잔액 확인

내 Africa's Talking 계좌 잔액은 얼마입니까?
현재 잔액을 보여 주실 수 있나요?
내 통화시간 잔액을 확인하세요.

통화 시간 보내기

0712345678로 100 KES 통화료를 보내세요.
제 0712345678에 60을 충전해 주세요.
50 NGN을 +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 처럼 도구 호출을 지원하는 모델에서 가장 잘 작동합니다. 가격에 민감하다면 Goose와 같은 클라이언트와 함께 사용할 경우 GPT-4.1 Nano 저렴하고 좋은 옵션입니다.

🙏 크레딧

아프리카의 토킹 API 아프리카의 토킹 문서 .

Africa's Talking Airtime MCP

Integrations