이 프로젝트는 Mifos X Ecosystem의 Model Context Protocol (MCP)를 제공하여 금융 데이터 및 운영에 액세스 할 수 있습니다.

구현은:

• Go (Native) - 102형 도구 (SSE/Stdio와 고성능, 클라우드 기반).
• **Java (Quarkus) ** - 38 유형의 도구 (Backoffice 및 권장).
• **Python (FastMCP) ** - 49 유형 도구 (모듈형 도메인 구동 디자인).
• Rust - 89가지 유형의 도구(고기능 Async I/O with Exclusive Bulk operations).

---

건축 개요

Mifos MCP Server는 Apache Fineract 뱅킹 백엔드에 AI 조수 또는 에이전트 프레임워크를 브리핑하는 독립적이고 무지한 통합 계층 역할을 합니다.

이 저장소는 framework-agnostic입니다. 클라이언트(LLM Brain, UI, Memory)는 별도의 저장소에 살고 있습니다. 모든 MCP 호환 시스템은 플러그 할 수 있습니다.

---

Agentic 플랫폼 아키텍처

Agentic Gateway는 Mifos X WebApp copilot 뒤에 일반 LLM 게이트웨이를 대체하기 위해 이러한 MCP 서버에 구축하여 전문화된 에이전트의 회전을 실행합니다.

• 사용자 채널 — Mifos WebApp (Chat / Copilot UI), Mifos Pay, Mifos Mobile, Mifos Field Officer 및 Mifos Web Banking.

Mifos MCP - Model Context Protocol (MCP)

This project provides Model Context Protocol (MCP) for the Mifos X Ecosystem, enabling AI agents to access financial data and operations.

Implementations are available in:

• Go (Native) — 102 typed tools (high-performance, cloud-native with SSE/Stdio).
• Java (Quarkus) — 38 typed tools (across Backoffice and Recommendations).
• Python (FastMCP) — 76 typed tools (modular domain-driven design).
• Rust — 89 typed tools (high-performance async I/O with exclusive bulk operations).

---

Architecture Overview

The Mifos MCP Server acts as a standalone, stateless integration tier that bridges any AI assistant or agent framework to the Apache Fineract banking backend.

┌──────────────────────────────────────────────┐
│            Apache Fineract / Mifos X          │
└───────────────────────┬──────────────────────┘
                        │ REST API
┌───────────────────────────────▼───────────────────────────────┐
│                 mcp-mifosx (Primary Repo)                     │
│                                                               │
│  ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐  │
│  │   /go (Native)  │ │ /java (Quarkus) │ │/python (FastMCP)│ │  /rust (Tokio)  │  │
│  │                 │ │                 │ │                 │ │                 │  │
│  │ - 102 Tools     │ │ - 38 Tools      │ │ - 76 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)

This repository is framework-agnostic. The client (LLM brain, UI, memory) lives in a separate repository. Any MCP-compatible system can plug in.

---

Agentic Platform Architecture

The Agentic Gateway builds on these MCP servers to replace the plain LLM gateway behind the Mifos X WebApp copilot with an agent harness running a swarm of specialized agents.

• User channels — Mifos WebApp (Chat / Copilot UI), Mifos Pay, Mifos Mobile, Mifos Field Officer and Mifos Web Banking. The Agent CLI is an optional entry point for developers and power users.
• Agentic Gateway — reuses the existing Mifos AI Gateway endpoint, but routes requests to an agent harness instead of directly to an LLM.