mcp-mifosx | 通往MCP之路

Mifos X - AI - 模型上下文协议 (MCP) for Apache Fineract®

本项目提供了与 Apache Fineract API 交互的模型上下文协议 (MCP) 服务器，使 AI 代理能够访问金融数据和操作。目前支持 Python、Java (Quarkus) 和 Node.js 三种实现。

MCP 开发者工具

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

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

快速开始

1. 选择你的实现方式

Python (Flask)

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

步骤:

安装依赖：

运行服务器：

Java (Quarkus)

前提条件: JDK 17+，Maven

步骤:

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

通过 JBang 快速运行：

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

Node.js

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

步骤:

安装依赖：

在 .env 中配置环境变量：

运行服务器：

使用内置的 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)，可以构建原生可执行文件：

使用 MCP Inspector 进行测试

启动你的 MCP 服务器（Python/Java/Node.js）。

运行 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 传输方式

环境无关的配置