返回市场
MCP-米福斯X服务器

MCP-米福斯X服务器

作者:openMF18 星标更新:2025-11-23

项目介绍

Mifos MCP - 模型上下文协议 (MCP)

该项目为Mifos X生态系统提供了模型上下文协议 (MCP),使AI代理能够访问金融数据和操作。实现方式包括Java (Quarkus)


MCP 开发工具

使用 MCP Inspector 来测试和调试你的服务器:

npx @modelcontextprotocol/inspector

这将启动一个本地Web界面,通过STDIO或SSE连接到你的MCP服务器。


快速开始

1. 选择你的实现方式

Java (Quarkus)

前提条件:JDK 21+,Maven

步骤

  1. 在你的shell或IDE中配置环境变量:
    export MIFOSX_BASE_URL="https://your-fineract-instance"
    export MIFOSX_BASIC_AUTH_TOKEN="your_api_token"
    export MIFOS_TENANT_ID="default"
    
  2. 使用JBang运行(快速执行):
    jbang --quiet org.mifos.community.ai:mcp-server:1.0.0-SNAPSHOT:runner
    
  3. (可选)构建本机可执行文件:
    ./mvnw package -Dnative
    ./target/mcp-server-1.0.0-SNAPSHOT-runner
    

配置

所有实现都需要以下环境变量:

变量描述
FINERACT_BASE_URLFineract 实例的基本URL
FINERACT_BASIC_AUTH_TOKENAPI认证令牌
FINERACT_TENANT_ID租户标识符(默认:default

注意:Java使用带有MIFOSX_前缀的变量(例如,MIFOSX_BASE_URL)。


构建本机可执行文件(仅限Java)

对于Java (Quarkus),创建一个本机可执行文件:

./mvnw package -Dnative -Dquarkus.native.container-build=true
./target/mcp-server-1.0.0-SNAPSHOT-runner

使用MCP Inspector进行测试

  1. 启动你的MCP服务器(Python/Java/Node.js)。
  2. 运行检查器:
    npx @modelcontextprotocol/inspector
    
  3. 使用STDIO传输连接到服务器。

示例 - 后台代理

视频URL标题提示
https://youtu.be/MDQKRoz5GKw?si=69X77C58nFhy6Ioh加入并尝试Mifos MCP。前往 https://ai.mifos.communityN/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。添加备注“紧急支出”。

联系


关键特性:

  • 符合MCP标准,支持STDIO/SSE传输
  • 环境无关配置