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:

npx @modelcontextprotocol/inspector

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

Related MCP server: poke-bank

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:

./mvnw package -Dnative -Dquarkus.native.container-build=true
./target/mcp-server-1.0.0-SNAPSHOT-runner

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