How gkbishnoi07/mcp-mifosx works
Mifos MCP is a set of stateless, framework-agnostic servers exposing Apache Fineract banking operations to MCP-compatible assistants. The principal flow is an assistant invoking a domain tool through a server transport; the implementation adapts the request to Fineract REST and returns a result. Go, Rust, Python, and Java provide distinct implementations, while the repository also contains an agentic copilot and loan-origination services. README statements establish the cross-product integrations; sampled source confirms only selected internal calls, so uncertain internal links are omitted.
Main entry points: server.rs Rust MCP server · LoanOrchestrationService.java Loan orchestration · AgentLoop.java Agent loop · http_server.go Go transport
Components 30
MCP implementations
- Go transport
go/server/http_server.go - Go banking tools
go/tools - Go adapter
go/adapter/adapter.go - Rust MCP server
rust/src/server.rs - Rust tool registry
rust/src/registry.rs - Rust domain tools
rust/src/domains - Rust adapter
rust/src/adapter.rs - Python FastMCP
python/mcp_server.py - Python tool registry
python/tools/registry.py - Python domain tools
python/tools/domains - Python MCP adapter
python/tools/mcp_adapter.py - Java backoffice
java/backoffice/src/main/java/org/mifos/community/ai/mcp - Java recommendations
java/userrecommendation/src/main/java/org/mifos/community/ai/mcp - Fineract MCP tools
plugin/src/main/java/org/apache/fineract/infrastructure/mcp/tools
Copilot gateway
- Chat endpoint
gateway/src/main/java/org/mifos/community/copilot/gateway/web/ChatController.java - Agent loop
gateway/src/main/java/org/mifos/community/copilot/core/agent/AgentLoop.java - Fineract tool executor
gateway/src/main/java/org/mifos/community/copilot/core/tools/FineractRestToolExecutor.java
Loan origination
- Loan API
agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/controller/LoanController.java - Loan orchestration
agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LoanOrchestrationService.java - Local underwriting
agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LocalUnderwritingService.java - Loan case state
agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LoanCaseStore.java
Document classification
- Classifier API
agentic-loan-doc-classifier/src/main/java/org/community/mifos/ai/decision/controller/DocumentClassifierController.java - Statement classifier
agentic-loan-doc-classifier/src/main/java/org/community/mifos/ai/decision/service/BankStatementClassifierService.java
Other components
- MCP assistant
- Apache Fineract
- Copilot user
- LLM provider
- Loan applicant
- OpenFn workflow
- Ollama model
Connections 30
- MCP assistant → Go transport: invokes tools
README.md - MCP assistant → Rust MCP server: invokes tools
README.md - MCP assistant → Python FastMCP: invokes tools
README.md - MCP assistant → Java backoffice: invokes tools
README.md - Go transport → Go banking tools: dispatches calls
- Go banking tools → Go adapter: uses adapter
- Go adapter → Apache Fineract: REST requests
README.md - Rust MCP server → Rust tool registry: routes intents
rust/src/server.rs - Rust MCP server → Rust domain tools: dispatches tools
rust/src/server.rs - Rust MCP server → Rust adapter: uses adapter
rust/src/server.rs - Rust adapter → Apache Fineract: REST requests
README.md - Python FastMCP → Python tool registry: registers tools
- Python tool registry → Python domain tools: exposes domains
- Python domain tools → Python MCP adapter: uses adapter
python/tools/domains/clients.py - Python MCP adapter → Apache Fineract: REST requests
README.md - Java backoffice → Apache Fineract: REST requests
README.md - Java recommendations → Apache Fineract: REST requests
README.md - Fineract MCP tools → Apache Fineract: banking operations
- Copilot user → Chat endpoint: sends chat
README.md - Chat endpoint → Agent loop: runs turn
gateway/src/main/java/org/mifos/community/copilot/gateway/web/ChatController.java - Agent loop → LLM provider: requests completion
- Agent loop → Fineract tool executor: dispatches tools
- Fineract tool executor → Apache Fineract: calls REST
README.md - Loan applicant → Loan API: submits application
- Loan API → Loan orchestration: starts case
- Loan orchestration → Loan case state: stores state
agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LoanOrchestrationService.java - Loan orchestration → OpenFn workflow: triggers workflow
agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LoanOrchestrationService.java - Loan orchestration → Local underwriting: fallback assessment
agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LoanOrchestrationService.java - Classifier API → Statement classifier: evaluates documents
agentic-loan-doc-classifier/src/main/java/org/community/mifos/ai/decision/controller/DocumentClassifierController.java - Statement classifier → Ollama model: classifies document
agentic-loan-doc-classifier/src/main/java/org/community/mifos/ai/decision/service/BankStatementClassifierService.java