该项目为Mifos X生态系统提供了模型上下文协议 (MCP),使AI代理能够访问金融数据和操作。实现方式包括Java (Quarkus)。
使用 MCP Inspector 来测试和调试你的服务器:
npx @modelcontextprotocol/inspector
这将启动一个本地Web界面,通过STDIO或SSE连接到你的MCP服务器。
前提条件:JDK 21+,Maven
步骤:
export MIFOSX_BASE_URL="https://your-fineract-instance"
export MIFOSX_BASIC_AUTH_TOKEN="your_api_token"
export MIFOS_TENANT_ID="default"
jbang --quiet org.mifos.community.ai:mcp-server:1.0.0-SNAPSHOT:runner
./mvnw package -Dnative
./target/mcp-server-1.0.0-SNAPSHOT-runner
所有实现都需要以下环境变量:
| 变量 | 描述 |
|---|---|
FINERACT_BASE_URL | Fineract 实例的基本URL |
FINERACT_BASIC_AUTH_TOKEN | API认证令牌 |
FINERACT_TENANT_ID | 租户标识符(默认:default) |
注意:Java使用带有MIFOSX_前缀的变量(例如,MIFOSX_BASE_URL)。
对于Java (Quarkus),创建一个本机可执行文件:
./mvnw package -Dnative -Dquarkus.native.container-build=true
./target/mcp-server-1.0.0-SNAPSHOT-runner
npx @modelcontextprotocol/inspector
STDIO传输连接到服务器。| 视频URL | 标题 | 提示 |
|---|---|---|
| https://youtu.be/MDQKRoz5GKw?si=69X77C58nFhy6Ioh | 加入并尝试Mifos MCP。前往 https://ai.mifos.community | N/A |
| https://youtu.be/y5MR3j8EGM4?si=zXTurBNql4xF5CGY | 创建客户 | 使用名字:OCTAVIO,姓氏:PAZ,电子邮件地址:octaviopaz@mifos.org,手机号码:5518098299 和外部ID:OCPZ99 创建客户 |
| https://youtu.be/qJsC25cd-1g?si=qQzX8DeOe0_2qhfr | 激活客户 | 激活客户 OCTAVIO PAZ |
| https://youtu.be/X1g_nVDsRnM?si=K7vsAN7gOLEC2OG0 | 为客户添加地址 | 为客户 OCTAVIO PAZ 添加地址。字段:地址类型:HOME,地址:PLAZA DE LORETO,街区:DOCTOR ALFONZO,门牌号:NUMBER 10,城市:CDMX,国家:MÉXICO,邮政编码:54440,州/省:CDMX。 |
| https://youtu.be/xeL9_sycwA8?si=AtV6F4WhTvcDspSp | 为客户添加个人联系人 | 为客户 OCTAVIO PAZ 添加家庭成员。名字:Maria,中间名:Elena,姓氏:Ramírez,年龄:27,关系:妹妹,性别:女性,出生日期:1998年3月15日,学历:学士学位,是否依赖,职业:学生,婚姻状况:单身。 |
| https://youtu.be/IKGMeAJBAOk?si=N27rE64dn7qxmMBk | 创建贷款产品 | 创建名为“SILVER”的默认贷款产品,简称“ST01”,本金10000,5次还款,名义利率10.0%,还款频率2个月,货币USD。 |
| https://youtu.be/5EdgUyLyP0w?si=L0UdYjXlyYF6faL5 | 创建贷款申请 | 为客户提供个人贷款账户申请,使用贷款产品SILVER。 |
| https://youtu.be/2ioN_8z_uaY?si=ZTB5rCrgS2jTpC4- | 批准贷款申请 | 批准贷款账户 |
| https://youtu.be/dDebmrn4lB0?si=0GTf4asCBHnsu27f | 贷款发放 | 使用付款类型Money Transfer发放贷款账户。 |
| https://youtu.be/N3wnyJCh_Ik?si=gSy5LrJdFF2kfzHd | 还贷 | 对贷款账户6进行还款,使用Money Transfer。设置金额为6687.59,日期为2025年8月6日,并使用外部ID RT33。添加备注“FYI”,并包含支付账户号码100,支票号码101,路由代码102,收据号码103,银行号码1。 |
| https://youtu.be/bOuTj97hyqU?si=9bpno4Kp0II1IfPY | 创建储蓄产品 | 创建名为“WALLET”的默认储蓄产品,简称“TSWL”,描述“WALLET PRODUCT”,货币代码“USD”。 |
| https://youtu.be/l-Z7LlE3AnM?si=yQM4lloJL8Hu6yv8 | 创建储蓄账户申请 | 为客户提供储蓄账户申请,使用储蓄产品WALLET和外部ID STP1。 |
| https://youtu.be/Q5ExlhalG8U?si=TwbsUZX30G3JeNJy | 批准储蓄账户申请 | 批准储蓄账户,并包含备注:“我的第一次批准”。 |
| https://youtu.be/DJgUiRYK-rE?si=YatfVgOgpbP4wV91 | 激活储蓄账户 | 激活储蓄账户 |
| https://youtu.be/Od7KFqktUtI?si=gPJNlLOB_7D74QdS | 创建存款交易 | 为客户创建储蓄交易,账户号码1。这是一笔5000的存款,使用Money Transfer。备注应为“每月储蓄”。 |
| https://youtu.be/9OL6N5wKG7c?si=R50RjTK6GI_ODuUs | 创建取款交易 | 为客户创建储蓄交易,账户号码1。这是一笔2000的取款,使用Money Transfer。添加备注“紧急支出”。 |