银行工具集

BIA MCP是一个基于Python的银行工具集,提供余额查询、交易记录获取、账单支付和资金转账等功能,适用于银行间金融操作和自动化工作流程。

  • by jeffersonCueva
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 jeffersonCueva/BIA-MCP

使用说明

BIA MCP

该项目提供了一个基于Python的银行工具集,使用 FastMCP。它允许您:

  • 从不同银行检索用户余额。
  • 获取交易历史记录。
  • 通过清算所在同一银行内和跨银行的用户之间转移资金。

先决条件

确保已安装以下内容:

  • Python 3.13

使用以下方式安装依赖项:

pip install -r requirements.txt

配置

  1. 银行API: 更新 BANK_APIS 字典中包含您要连接的银行的网址。
BANK_APIS = {
    "gcash": "http://localhost:8002",
    "bpi": "http://localhost:8003",
}
  1. 清算所: 为银行间转账设置清算所API端点。
CLEARING_HOUSE_API = "http://localhost:9000"

提供的工具

1.获得平衡

get_balance(user: str, bank: str) -> int
  • 获取特定银行中用户的余额。

2.获取交易

get_transactions(user: str, bank: str) -> list
  • 检索用户的交易历史记录。

3.付款单

pay_bill(user: str, bank: str, biller_code: str, reference_number: str, amount: int) -> str
  • 通过任何注册银行支付账单。
  • 支持具有不同计费器代码的多个计费器。
  • 需要账户持有人姓名、银行、记账人详细信息和付款金额。

4.转账

transfer_funds(from_user: str, from_bank: str, to_user: str, to_bank: str, amount: int) -> str
  • 支持同一银行和银行间转账。
  • 使用清算所进行银行间交易。

运行MCP服务器

运行FastMCP开发服务器以启动MCP实例并注册所有工具:

fastmcp dev server.py
  • 替换 server.py 如果不同,请使用脚本的文件名。
  • 运行后,MCP实例 BIA 将公开在其他应用程序或自动化工作流中使用的工具。

日志记录

  • 在启用日志记录 信息 水平。
  • HTTP请求中的错误会记录详细信息以供调试。

备注

  • 在发出请求之前,确保所有后端银行API和清算所都在运行。
  • 为每个API调用配置超时设置(5-10秒,具体取决于操作)。
  • 用于开发/演示目的。

许可证

按原样提供,用于教育和黑客马拉松目的。