Daraja MCP

Daraja MCP

site icon
2025.04.01 8
Python金融自动化支付处理AI集成金融服务
Daraja MCP 是一个模型上下文协议(MCP)服务器,旨在将AI应用程序与Safaricom的Daraja API集成,实现与M-Pesa服务的无缝交互。该服务器目前处于开发阶段,不建议用于生产环境,主要用于学习、实验、开发和测试环境以及概念验证。 ### 核心功能 - **AI驱动的M-Pesa交易**:支持B2C、C2B和B2B支付。 - **标准化集成**:确保与多种AI工具的兼容性。 - **安全与可扩展性**:实现OAuth认证,支持企业级交易处理。 - **灵活自动化**:AI代理可以查询账户余额、生成发票和自动化对账。 ### 适用场景 - 开发与测试环境中的金融自动化。 - AI驱动的支付处理和数据查询。 - 概念验证和实验性项目。
View on GitHub

Overview

基本能力

产品定位

Daraja MCP 是一个连接AI、金融科技和M-Pesa的桥梁,通过标准化LLM(大型语言模型)与金融交易之间的连接,使AI驱动的应用程序能够轻松处理支付、检索交易数据和自动化财务工作流。

核心功能

  • AI驱动的M-Pesa交易:支持B2C、C2B和B2B支付。
  • 标准化集成:确保与多种AI工具的兼容性。
  • 安全与可扩展性:实现OAuth认证,支持企业级交易处理。
  • 灵活自动化:AI代理可以查询账户余额、生成发票和自动化对账。

适用场景

  • 开发与测试环境中的金融自动化。
  • AI驱动的支付处理和数据查询。
  • 概念验证和实验性项目。

工具列表

  1. stk_push:发起M-Pesa STK推送请求,提示客户在移动设备上授权支付。
  2. generate_qr_code:生成支付请求的QR码,供客户扫描支付。
  3. create_source:创建从数据源到非结构化服务器的连接器。
  4. create_destination:创建从非结构化服务器到数据存储目标的连接器。
  5. create_workflow:创建工作流以处理从源连接器到目标连接器的数据。
  6. run_workflow:执行工作流。
  7. get_workflow_details:获取工作流的详细信息。
  8. fetch_documents:获取工作流执行期间分析的文档。

常见问题解答

  • 是否可用于生产环境? 目前不建议用于生产环境,仅适用于开发和测试。
  • 如何获取API凭证? 需要Safaricom Daraja API的Consumer Key和Secret。
  • 如何配置Claude Desktop? 需要编辑配置文件并添加服务器配置。

使用教程

使用依赖

  1. Python 3.12:确保已安装Python 3.12。
  2. Safaricom Daraja API凭证:获取Consumer Key和Secret。

安装教程

  1. 安装uv包管理器
  2. Mac/Linux: bash curl -LsSf https://astral.sh/uv/install.sh | sh
  3. Windows (PowerShell): powershell powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  4. 克隆仓库 bash git clone https://github.com/jameskanyiri/DarajaMCP.git cd DarajaMCP
  5. 创建并激活虚拟环境 bash uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
  6. 安装依赖 bash uv sync
  7. 设置环境变量 bash cp .env.example .env 更新.env文件中的凭证和配置值。

调试方式

  1. 配置Claude Desktop
  2. 编辑配置文件并添加服务器配置。
  3. 示例配置: json { "mcpServers": { "daraja": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/PARENT/FOLDER/DarajaMCP", "run", "main.py" ] } } }
  4. 验证配置
  5. 保存配置文件并重启Claude Desktop。
  6. 查找界面中的锤子🔨图标,查看可用工具。

许可证

该项目遵循 MIT 开源许可条款。