BIA MCP
该项目提供了一个基于Python的银行工具集,使用 FastMCP。它允许您:
- 从不同银行检索用户余额。
- 获取交易历史记录。
- 通过清算所在同一银行内和跨银行的用户之间转移资金。
______________________________________________________________________
先决条件
确保已安装以下内容:
- Python 3.13
使用以下方式安装依赖项:
pip install -r requirements.txt______________________________________________________________________
配置
- 银行API:
更新 BANK_APIS 字典中包含您要连接的银行的网址。
BANK_APIS = {
"gcash": "http://localhost:8002",
"bpi": "http://localhost:8003",
}- 清算所:
为银行间转账设置清算所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秒,具体取决于操作)。
- 用于开发/演示目的。
______________________________________________________________________
许可证
按原样提供,用于教育和黑客马拉松目的。
