mcp-mifosx

Mifos X – KI – Model Context Protocol (MCP) für Apache Fineract®

Dieses Projekt bietet Model Context Protocol (MCP)-Server für die Interaktion mit der Apache Fineract API und ermöglicht KI-Agenten den Zugriff auf Finanzdaten und -vorgänge. Implementierungen sind in Python , Java (Quarkus) und Node.js verfügbar.

MCP-Entwicklertools

Verwenden Sie den MCP Inspector, um Ihren Server zu testen und zu debuggen:

Dadurch wird eine lokale Web-Benutzeroberfläche gestartet, um über STDIO oder SSE eine Verbindung zu Ihrem MCP-Server herzustellen.

Erste Schritte

1. Wählen Sie Ihre Implementierung

Python (Flask)

Voraussetzungen : Python 3.8+, flask , mcp.server.fastmcp

Schritte :

1. Installieren Sie Abhängigkeiten:
   pip install mcp[cli] uv flask

   Hinweis für Zsh-Benutzer : Wenn Sie Zsh verwenden, achten Sie darauf, Extras in Anführungszeichen zu setzen, um Shell-Erweiterungsfehler zu vermeiden:

   pip install 'mcp[cli]' uv flask

2. Führen Sie den Server aus:
   mcp dev app.py

Java (Quarkus)

Voraussetzungen : JDK 17+, Maven

Schritte :

1. Konfigurieren Sie Umgebungsvariablen in Ihrer Shell oder IDE:
   export MIFOSX_BASE_URL="https://your-fineract-instance" export MIFOSX_BASIC_AUTH_TOKEN="your_api_token" export MIFOS_TENANT_ID="default"
2. Über JBang ausführen (für schnelle Ausführung):
   jbang --quiet org.mifos.community.ai:mcp-server:1.0.0-SNAPSHOT:runner
3. (Optional) Erstellen Sie eine native ausführbare Datei:
   ./mvnw package -Dnative ./target/mcp-server-1.0.0-SNAPSHOT-runner

Node.js

Voraussetzungen : Node.js 16+, npm

Schritte :

1. Installieren Sie Abhängigkeiten:
   cd nodejs && npm install
2. Konfigurieren Sie Umgebungsvariablen in .env :
   cp .env.example .env
3. Führen Sie den Server aus:
   npm run dev
4. Testen Sie mit dem integrierten inspect :
   npm run inspect

Konfiguration

Alle Implementierungen erfordern die folgenden Umgebungsvariablen:

Hinweis : Java verwendet Variablen mit dem Präfix MIFOSX_ (z. B. MIFOSX_BASE_URL ).

Verfügbare Ressourcen

Der MCP-Server stellt diese Ressourcen bereit:

Kernressourcen

• fineract://clients
  Alle Clients auflisten
• fineract://clients/{clientId}
  Details zu einem bestimmten Kunden abrufen
• fineract://loans
  Alle Kredite auflisten
• fineract://loans/{loanId}
  Details zu einem bestimmten Darlehen erhalten

Werkzeuge

• search_clients
  Suchen Sie nach Kunden nach Namen/Attributen
• create_client
  Einen neuen Client erstellen (nur Node.js/Python)
• update_loan_status
  Kreditstatus aktualisieren (nur Java/Python)

Erstellen nativer ausführbarer Dateien (nur Java)

Erstellen Sie für Java (Quarkus) eine native ausführbare Datei:

Testen mit MCP Inspector

1. Starten Sie Ihren MCP-Server (Python/Java/Node.js).
2. Führen Sie den Inspektor aus:
   npx @modelcontextprotocol/inspector
3. Stellen Sie mithilfe des STDIO -Transports eine Verbindung zum Server her.

Beitragen

• Python : Ändern Sie python/app.py und server.js für neue Ressourcen.
• Java : Erweitern Sie src/main/java/org/mifos/community/ai/... für neue Endpunkte.
• Node.js : Aktualisieren Sie nodejs/src/server.js und fügen Sie Zod-Schemas zur Validierung hinzu.

Kontakt

• Apache Fineract-Community: https://community.apache.org/
• MCP-Spezifikation: https://modelcontextprotocol.org

Anleitungen

• Java/Quarkus : Quarkus MCP-Handbuch
• Node.js : Verwenden Sie npm run inspect zum Live-Neuladen
• Python : Mit python app.py ausführen und .env konfigurieren

Hauptmerkmale:

• Standardisierter API-Zugriff über fineract:// URIs
• MCP-kompatibel mit STDIO/SSE-Transporten
• Umgebungsunabhängige Konfiguration