mcp-mifosx

Mifos X - IA - Protocolo de contexto de modelo (MCP) para Apache Fineract®

Este proyecto proporciona servidores de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de Apache Fineract, lo que permite a los agentes de IA acceder a datos y operaciones financieras. Las implementaciones están disponibles en Python , Java (Quarkus) y Node.js.

Herramientas para desarrolladores de MCP

Utilice el Inspector MCP para probar y depurar su servidor:

Esto inicia una interfaz de usuario web local para conectarse a su servidor MCP a través de STDIO o SSE.

Empezando

1. Elija su implementación

Python (Flask)

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

Pasos :

1. Instalar dependencias:
   pip install mcp[cli] uv flask

   Nota para los usuarios de zsh : si usa zsh, asegúrese de citar los extras para evitar errores de expansión de shell:

   pip install 'mcp[cli]' uv flask

2. Ejecutar el servidor:
   mcp dev app.py

Java (Quarkus)

Prerrequisitos : JDK 17+, Maven

Pasos :

1. Configure las variables de entorno en su shell o IDE:
   export MIFOSX_BASE_URL="https://your-fineract-instance" export MIFOSX_BASIC_AUTH_TOKEN="your_api_token" export MIFOS_TENANT_ID="default"
2. Ejecutar a través de JBang (para una ejecución rápida):
   jbang --quiet org.mifos.community.ai:mcp-server:1.0.0-SNAPSHOT:runner
3. (Opcional) Construya un ejecutable nativo:
   ./mvnw package -Dnative ./target/mcp-server-1.0.0-SNAPSHOT-runner

Node.js

Prerrequisitos : Node.js 16+, npm

Pasos :

1. Instalar dependencias:
   cd nodejs && npm install
2. Configurar variables de entorno en .env :
   cp .env.example .env
3. Ejecutar el servidor:
   npm run dev
4. Prueba con el script inspect incorporado:
   npm run inspect

Configuración

Todas las implementaciones requieren las siguientes variables de entorno:

Nota : Java utiliza variables con prefijo MIFOSX_ (por ejemplo, MIFOSX_BASE_URL ).

Recursos disponibles

El servidor MCP expone estos recursos:

Recursos básicos

• fineract://clients
  Listar todos los clientes
• fineract://clients/{clientId}
  Obtener detalles de un cliente específico
• fineract://loans
  Listar todos los préstamos
• fineract://loans/{loanId}
  Obtenga detalles de un préstamo específico

Herramientas

• search_clients
  Buscar clientes por nombre/atributos
• create_client
  Crear un nuevo cliente (solo Node.js/Python)
• update_loan_status
  Actualizar el estado del préstamo (solo Java/Python)

Creación de ejecutables nativos (solo Java)

Para Java (Quarkus), cree un ejecutable nativo:

Pruebas con MCP Inspector

1. Inicie su servidor MCP (Python/Java/Node.js).
2. Ejecute el inspector:
   npx @modelcontextprotocol/inspector
3. Conéctese al servidor utilizando el transporte STDIO .

Contribuyendo

• Python : modificar python/app.py y server.js para nuevos recursos.
• Java : ampliar src/main/java/org/mifos/community/ai/... para nuevos puntos finales.
• Node.js : actualice nodejs/src/server.js y agregue esquemas Zod para la validación.

Contacto

• Comunidad Apache Fineract: https://community.apache.org/
• Especificación MCP: https://modelcontextprotocol.org

Guías

• Java/Quarkus : Guía de Quarkus MCP
• Node.js : utilice npm run inspect para la recarga en vivo
• Python : Ejecute con python app.py y configure .env

Características principales:

• Acceso a API estandarizado a través de URI fineract://
• Compatible con MCP con transportes STDIO/SSE
• Configuración independiente del entorno