Darajamcp

🚀 プロジェクト説明

このプロジェクトは、Anthropic MCPフレームワークに基づくDarajaインターフェースを提供し、SafaricomのM-Pesa APIとの相互作用を可能にすることを目的としています。現在の主な機能は、アクセストークンの生成と、将来実装予定のいくつかの機能（stk_push、取引状態の照会など）です。ユーザーは特定のツールを呼び出すか、提供されたプロンプトを使用して、さまざまな支払い操作を行うことができます。

✨ 主な機能

支払いツール

stk_push

M-Pesa STKプッシュ要求を送信し、顧客に携帯電話で支払いを承認するよう求めます。

入力パラメータ:

• amount (int): 支払いする金額
• phone_number (int): 顧客の電話番号

戻り値: JSON形式のM-PESA API応答結果

generate_qr_code

支払い要求用のQRコードを生成します。顧客はこのQRコードをスキャンして支払いを完了できます。

入力パラメータ:

• merchant_name (str): 店舗名 / M-Pesa店舗名
• transaction_reference_no (str): 取引参照番号
• amount (int): 販売/取引の総額
• transaction_type (Literal["BG", "WA", "PB", "SM", "SB"]): 取引タイプ
• credit_party_identifier (str): 支払い側識別子（携帯電話番号、企業電話番号、代理店レジ、Paybill、または店舗の商品購入）

戻り値: QRコードデータを含むJSON形式のM-PESA API応答結果

支払いプロンプト

stk_push_prompt

M-Pesa STKプッシュ支払い要求を送信するためのプロンプトを生成します。

入力パラメータ:

• phone_number (str): 顧客の電話番号
• amount (int): 支払いする金額
• purpose (str): 支払い目的

戻り値: フォーマットされたSTKプッシュ要求プロンプト文字列

generate_qr_code_prompt

M-Pesa QRコード支払い要求を作成するためのプロンプトを生成します。

入力パラメータ:

• merchant_name (str): 店舗名
• amount (int): 支払いする金額
• transaction_type (str): 取引タイプ（BGは商品購入、WAはウォレット、PBはPaybill、SMは個人への送金、SBは企業への送金を表す）
• identifier (str): 受取人識別子（電話番号、企業番号、代理店レジ、Paybill、または店舗のBuyGoods）
• reference (str, optional): 取引参照番号。指定されない場合は自動生成されます。

戻り値: フォーマットされたQRコード生成プロンプト文字列

ドキュメント処理ツール

create_source

データソースから非構造化サーバーへのコネクタを作成し、データ処理を行います。

入力パラメータ:

• connector_name (str): 作成するデータソースコネクタの名前

戻り値: 名前とIDを含むソースコネクタの詳細情報

create_destination

非構造化サーバーからターゲットストレージへのコネクタを作成します。

入力パラメータ:

• connector_name (str): 作成する宛先コネクタの名前

戻り値: 名前とIDを含む宛先コネクタの詳細情報

create_workflow

ソースコネクタから宛先コネクタへのデータ処理ワークフローを作成します。

入力パラメータ:

• workflow_name (str): ワークフローの名前
• source_connector_id (str): ソースコネクタの一意の識別子
• destination_connector_id (str): 宛先コネクタの一意の識別子

戻り値: ワークフローIDと状態（成功または失敗）を含む結果

delete_workflow

指定されたIDのワークフローを削除します。

入力パラメータ:

• workflow_id (str): 削除するワークフローの一意の識別子

戻り値: 削除操作の状態情報

ドキュメント処理プロンプト

process_document

ワークフローを使用してドキュメントを処理します。

入力パラメータ:

• workflow_id (str): ドキュメントを処理するためのワークフローID
• document_content (str): 処理するドキュメントの内容

戻り値: 処理結果を含む状態情報

📦 リソース

• ライセンス: このプロジェクトはMIT Licenseでライセンスされています。
• 謝辞: このプロジェクトにコードや提案を提供してくれたすべての開発者に感謝します。
• 連絡先: 何か質問や提案がある場合は、daraja@anthropic.comまでご連絡ください。

💻 使用例

基本的な使用法

# アクセストークンの生成例
token = get_access_token()
print(f"Generated access token: {token}")

# ワークフローを使用したドキュメント処理例
workflow_id = "your_workflow_id"
doc_content = "待处理的文档内容"
result = process_document(workflow_id, doc_content)
print(f"Document processing result: {result}")

戻り値の形式

すべてのAPI呼び出しは、次のようなJSONオブジェクトを返します。

{
  "status": "success",    // 状態：成功または失敗
  "message": "操作完成。",  // 操作のヒントメッセージ
  "data": {}              // 具体的なデータを格納するフィールド
}

エラー処理

エラーが発生した場合、APIはエラーの詳細情報を含むステータスコードとメッセージを返します。

このプロジェクトを使用することで、ユーザーはSafaricomのM-Pesaサービスと簡単に統合し、さまざまな支払い機能を実現することができます。