MCP-MifosX集成平台

@openMF/mcp-mifosx

0 Stars 327 次浏览 openMF 更新于 2026-08-23

将MCP服务器与Mifos X集成，Mifos X是金融机构的开源核心银行解决方案。有助于管理客户、贷款、储蓄、股份、金融交易以及生成财务报告。

金融

该服务暂未提供标准配置，请参考 README 手动接入

服务介绍

Mifos X - AI - Model Context Protocol (MCP) for Apache Fineract®

该项目提供了Model Context Protocol (MCP)服务器，用于与Apache Fineract API交互，使AI代理能够访问金融数据和操作。目前已有Python、Java (Quarkus) 和 Node.js 的实现。

MCP 开发工具

使用MCP Inspector来测试和调试您的服务器：

npx @modelcontextprotocol/inspector

这将启动一个本地Web UI，通过STDIO或SSE连接到您的MCP服务器。

入门指南

1. 选择您的实现方式

Python (Flask)

前提条件: Python 3.8+, flask, mcp.server.fastmcp

步骤:

安装依赖项：
```
pip install mcp[cli] uv flask
```
运行服务器：
```
mcp dev app.py
```

Java (Quarkus)

前提条件: JDK 17+, Maven

步骤:

在shell或IDE中配置环境变量：

export MIFOSX_BASE_URL="https://your-fineract-instance"
export MIFOSX_BASIC_AUTH_TOKEN="your_api_token"
export MIFOS_TENANT_ID="default"

通过JBang快速执行：

jbang --quiet org.mifos.community.ai:mcp-server:1.0.0-SNAPSHOT:runner

（可选）构建原生可执行文件：

./mvnw package -Dnative
./target/mcp-server-1.0.0-SNAPSHOT-runner

Node.js

前提条件: Node.js 16+, npm

步骤:

安装依赖项：
```
cd nodejs && npm install
```
在.env文件中配置环境变量：
```
cp .env.example .env
```
运行服务器：
```
npm run dev
```
使用内置的inspect脚本进行测试：
```
npm run inspect
```

配置

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

变量	描述
`FINERACT_BASE_URL`	您的Fineract实例的基本URL
`FINERACT_BASIC_AUTH_TOKEN`	API认证令牌
`FINERACT_TENANT_ID`	租户标识符（默认：`default`）

注意：Java使用以MIFOSX_为前缀的变量（例如，MIFOSX_BASE_URL）。

可用资源

MCP服务器公开了以下资源：

核心资源

fineract://clients
列出所有客户
fineract://clients/{clientId}
获取特定客户的详细信息
fineract://loans
列出所有贷款
fineract://loans/{loanId}
获取特定贷款的详细信息

工具

search_clients
按名称/属性搜索客户
create_client
创建新客户（仅限Node.js/Python）
update_loan_status
更新贷款状态（仅限Java/Python）

构建原生可执行文件（仅Java）

对于Java (Quarkus)，创建一个原生可执行文件：

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

使用MCP Inspector进行测试

启动你的 MCP 服务器（Python/Java/Node.js）。
运行检查器：
```
npx @modelcontextprotocol/inspector
```
使用 STDIO 传输连接到服务器。

贡献

Python: 修改 python/app.py 和 server.js 以添加新资源。
Java: 扩展 src/main/java/org/mifos/community/ai/... 以添加新端点。
Node.js: 更新 nodejs/src/server.js 并添加 Zod 模式进行验证。

联系

Apache Fineract 社区: https://community.apache.org/
MCP 规范: https://modelcontextprotocol.org

指南

Java/Quarkus: Quarkus MCP 指南
Node.js: 使用 npm run inspect 进行实时重载
Python: 使用 python app.py 运行并配置 .env

主要特性：

通过 fineract:// URI 实现标准化 API 访问
支持 MCP 兼容 的 STDIO/SSE 传输
环境无关 配置

查看源码项目主页