关于 Mifos X - AI - Model Context Protocol (MCP) for Apache Fineract®
Mifos X - AI 是面向 Apache Fineract 与 Mifos X 生态的 MCP 服务，让 AI Agent 能访问金融数据并执行业务操作。项目提供 Go、Java、Python、Rust 四种实现，面向金融机构的后台与开发者。服务本身无状态，不存储用户数据。
主要功能
- 01提供 Go、Java、Python、Rust 四种实现
- 02工具覆盖客户、贷款、储蓄、团体等业务
- 03基于 Apache Fineract REST API 构建
- 04无状态设计，不保存用户数据或 PII
- 05通过 Fineract 原生权限校验每次操作
适用场景
- 01让 AI 助手查询与创建客户档案
- 02协助处理贷款申请、审批、放款与还款
- 03辅助储蓄账户开户、存取款操作
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
暂未收录安装方式
我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。
工具
还没有获取到工具列表
本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。
详细介绍
Mifos MCP - Model Context Protocol (MCP)
本项目为 Mifos X 生态系统提供 Model Context Protocol (MCP)，使 AI Agent 能够访问金融数据和操作。
现有实现包括：
- Go（原生） — 102 个类型化工具（高性能、云原生，支持 SSE/Stdio）。
- Java（Quarkus） — 38 个类型化工具（覆盖 Backoffice 和 Recommendations）。
- Python（FastMCP） — 49 个类型化工具（模块化领域驱动设计）。
- Rust — 89 个类型化工具（高性能异步 I/O，提供独占的批量操作）。
架构概述
Mifos MCP 服务是一个独立、无状态的集成层，将任何 AI 助手或 Agent 框架连接到 Apache Fineract 银行后端。
┌──────────────────────────────────────────────┐
│ Apache Fineract / Mifos X │
└───────────────────────┬──────────────────────┘
│ REST API
┌───────────────────────────────▼───────────────────────────────┐
│ mcp-mifosx (Primary Repo) │
│ │
│ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │
│ │ /go (Native) │ │ /java (Quarkus) │ │/python (FastMCP)│ │ /rust (Tokio) │ │
│ │ │ │ │ │ │ │ │ │
│ │ - 102 Tools │ │ - 38 Tools │ │ - 49 Tools │ │ - 89 Tools │ │
│ │ - Go Routines │ │ - Backoffice │ │ - Modular Design│ │ - Async I/O │ │
│ │ - SSE / Stdio │ │ - Recommend. │ │ │ │ - Bulk Actions │ │
│ └────────┬────────┘ └────────┬────────┘ └────────┬────────┘ └────────┬────────┘ │
└───────────┴───────────────────┼───────────────────┼───────────────────┴───────────┘
│ MCP Protocol (stdio / SSE)
┌─────────────┼──────────────┐
▼ ▼ ▼
Mifos X WebApp Claude Code n8n / Custom
AI Assistant (claude.ai) Workflow Agent
(your client) (external) (your client)
本仓库与框架无关。客户端（大模型大脑、UI、记忆）位于单独的仓库中。任何兼容 MCP 的系统都可以接入。
Agentic 平台架构
Agentic Gateway 构建在这些 MCP 服务之上，用运行一组专用 Agent 集群的 Agent Harness 替换 Mifos X WebApp copilot 背后的普通大模型网关。
- 用户渠道 — Mifos WebApp（Chat / Copilot UI）、Mifos Pay、Mifos Mobile、Mifos Field Officer 和 Mifos Web Banking。Agent CLI 是面向开发者和高级用户的可选入口。
- Agentic Gateway — 复用现有的 Mifos AI Gateway 端点，但将请求路由到 Agent Harness，而不是直接路由到大模型。
- Agent Harness（Pi / Prime / Hermes 的运行时）— 为每个 Agent 封装大模型提供商、大模型防火墙（安全与保障）、可观测性（日志 / 监控）和会话管理（工具编排）。
- 专用 Agent — Enrollment Agent、KYC/FT Reviewer、Loan Reviewer、Scoring Reviewer、Document Reviewer 等。它们的 Fineract 工具调用使用发起调用的工作人员的凭据和权限；Agent 没有单独的 Fineract 角色。
- MCP 工具 / 兼容 AG-UI 的工具 — Fineract、贷款、客户、产品、工作流、报表和自定义工具，由 Agent 按需调用。
- Apache Fineract + Grants / RBAC — 核心银行后端。Fineract 为已认证的工作人员强制执行 grants：如果工作人员的角色具有所需的 grant，则调用（包括写 API）成功；否则被拒绝。
- 外部系统（通过工具）— Scoring、Black List、Sanction List、National ID、Identity Verification 和 Biometrics 系统。
实现同步
虽然本仓库托管两种不同的编程语言，但在可能的情况下它们保持功能对等，以确保一致的体验。
它们如何“同步”：
- 工具规范：所有实现都力求暴露相同的核心银行工具。
- Go 目前以 102 个工具领先，具备先进的云原生功能和 SSE。
- Rust 提供 89 个工具，独有高并发批量操作和稳健的“Fetch-and-Merge”状态管理。
- Python 提供 49 个工具，采用模块化领域设计。
- Java 提供 38 个工具（21 个用于 Backoffice 操作，17 个用于 User Recommendations）。
- API 对齐：所有实现都基于相同的 Apache Fineract REST API 构建。它们共享完全相同的字段路由逻辑。
- 无状态对等：所有实现都遵循严格的无状态设计。所有服务都不存储用户数据、PII 或 AI 记忆。
- 测试协议：共享的“Smoke Tests”确保所有实现向大模型返回相同、可预测的 JSON 结构。
项目结构
本仓库的结构支持多种实现和客户端集成。
.
├── README.md # Root entry point & cross-implementation guide
├── go/ # Go Implementation (Native / High-Performance)
│ ├── tools/ # 102 Domain-specific tools (SSE/Stdio)
│ ├── server/ # Dual-transport logic (HTTP/SSE & Stdio)
│ └── main.go # Server entry point
├── rust/ # Rust Implementation (Tokio/Reqwest)
│ ├── src/ # Multi-threaded typed tools & bulk execution logic
│ └── Cargo.toml # Rust package dependencies
├── python/ # Python Implementation (FastMCP)
│ ├── mcp_server.py # Main entry point for the MCP server
│ ├── tools/ # Domain-specific banking tools (Loans, Clients, etc.)
│ └── core/ # API Gateway handlers
├── java/ # Java Implementation (Quarkus)
│ ├── backoffice/ # Core banking tools
│ └── userrecommendation/ # Recommendation engine tools
└── agentic-mifos-sandbox/ # Docker Compose sandbox: Fineract, OpenFn, Pi agents, LOS (see its README)
快速开始
1. 选择你的实现
Go（原生且云就绪）
前置条件：Go 1.21+
步骤：
- 配置环境：
将
go/.env.example复制为go/.env并更新凭据。 - 构建并运行：
cd go go build -o mcp-server . ./mcp-server - SSE 模式（可选）：
在
.env中定义PORT=8080，即可从 Stdio 切换为 SSE 微服务模式。
Rust（高性能）
前置条件：Rust（Cargo）
步骤：
- 配置环境：
将
rust/.env.example复制为rust/.env并更新凭据。 - 构建并运行：
cd rust cargo build --release ./target/release/mcp-rust-mifosx
Java（Quarkus）
前置条件：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 运行：
jbang --quiet org.mifos.community.ai:mcp-server:1.0.0-SNAPSHOT:runner - 构建原生可执行文件（可选）：
cd java/backoffice ./mvnw package -Dnative ./target/mcp-server-1.0.0-SNAPSHOT-runner
Python（FastMCP）
前置条件：Python 3.10+、pip
步骤：
- 进入 Python 目录：
cd python - 安装依赖：
pip install -r requirements.txt - 配置环境：
将
.env.example复制为.env并填写你的详细信息。 - 运行服务：
python mcp_server.py
可用工具摘要
工具的确切数量和分类取决于所部署的核心服务实现：
Go（102 个工具）
功能最完整的实现，具备原生并发例程。
- 客户与身份：16 个工具
- 文档与报表：26 个工具
- 贷款与储蓄：23 个工具
- 小组与中心：13 个工具
- 批量与组合：19 个工具（云原生）
- 会计与统计：5 个工具
Rust（89 个工具）
专为异步扩展、批量处理和稳健的状态感知更新而构建。
- 客户与抵押品：25 个工具
- 贷款与抵押品：19 个工具
- 小组、储蓄与中心：23 个工具
- 员工、会计与费用：11 个工具
- 批量操作：11 个工具 （Rust 独有）
Python（49 个工具）
领域驱动设计，将 AI 直接连接到 Fineract。
- 客户与小组：16 个工具
- 贷款与储蓄：20 个工具
- 员工与会计：13 个工具
Java（38 个工具）
企业级套件，分为后台办公和推荐引擎两类。
- 后台办公操作：21 个工具 （涵盖客户、贷款、储蓄）
- 用户推荐：17 个工具 （Java 独有）
使用 MCP Inspector 测试
使用 MCP Inspector 以交互方式测试和调试你的服务：
npx @modelcontextprotocol/inspector <command_to_run_yours_server>
对于 Python：
npx @modelcontextprotocol/inspector python python/mcp_server.py
示例 - Backoffice Agent
安全与防护措施
- 通用兼容性 — 可与 Claude、GPT-4、Qwen 或任何 MCP 客户端配合使用。
- 数据主权 — 服务不会进行任何外部调用。
- 强制执行 RBAC — 每个操作都会根据 Fineract 的原生权限进行验证。
联系方式与社区
- Mifos 社区：https://mifos.org
- Mifos MCP（Docker）：https://hub.docker.com/r/openmf/mifos-mcp
- 聊天机器人演示：https://ai.mifos.community
评论
支持 Markdown
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。