Chatbot bancario con integración MCP

Una sofisticada aplicación de chatbot bancario que utiliza Azure OpenAI y Model Context Protocol (MCP) para un manejo seguro y eficiente de mensajes.

Características

• Asistente bancario impulsado por IA : utiliza Azure OpenAI para proporcionar respuestas inteligentes a consultas bancarias

• Protocolo de contexto de modelo (MCP) : implementa un protocolo de comunicación de mensajes seguro

• Interfaz de chat en tiempo real : interfaz de usuario moderna y adaptable para una interacción fluida con el usuario

• Registro completo : sistema de registro detallado para monitoreo y depuración

• Integración de información bancaria : visualización dinámica de detalles y servicios bancarios

• Compatibilidad con Markdown : formato de texto enriquecido para respuestas

Related MCP server: agent2agent

Estructura del proyecto

.
├── app.py                  # Main Flask application
├── mcp_server.py          # MCP server implementation
├── mcp_client.py          # MCP client implementation
├── requirements.txt       # Python dependencies
├── .env                   # Environment variables
├── templates/             # HTML templates
│   └── index.html        # Chat interface
└── logs/                 # Log files
    ├── client_messages.log
    ├── mcp_client.log
    └── mcp_server.log

Prerrequisitos

• Python 3.8 o superior

• Acceso a la API de Azure OpenAI

• Paquetes de Python necesarios (consulte requirements.txt)

Instalación

1. Clonar el repositorio:

   git clone <repository-url>
   cd banking-chatbot

2. Crear y activar un entorno virtual:

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Instalar dependencias:

   pip install -r requirements.txt

4. Crea un archivo .env con tus credenciales:

   ENDPOINT_URL=your_azure_endpoint
   AZURE_OPENAI_API_KEY=your_api_key
   DEPLOYMENT_NAME=your_deployment_name

Uso

1. Inicie el servidor MCP:

   python mcp_server.py

2. En una nueva terminal, inicie la aplicación Flask:

   python app.py

3. Acceda a la interfaz del chatbot en http://localhost:5000

Protocolo MCP

El Protocolo de Contexto de Modelo (MCP) se implementa para gestionar la comunicación de mensajes entre el chatbot y el servidor. Proporciona:

• Transmisión segura de mensajes

• Colas de mensajes y confiabilidad

• Registro detallado

• Manejo de mensajes en tiempo real

Tipos de mensajes

• Mensajes de chat : consultas de usuarios y respuestas de IA

• Mensajes del sistema : Mensajes administrativos y de control

Explotación florestal

La aplicación mantiene registros detallados en el directorio logs :

• client_messages.log : Historial de mensajes de chat

• mcp_client.log : registros de conexión y operación del cliente

• mcp_server.log : registros de operaciones del servidor

Información bancaria

El chatbot está configurado con información bancaria completa que incluye:

• Horario comercial

• Ubicaciones de sucursales

• Servicios disponibles

• Información del contacto

• Canales de soporte

Desarrollo

Añadiendo nuevas funciones

1. Actualice el diccionario BANK_INFO en app.py para obtener nueva información bancaria

2. Modificar SYSTEM_MESSAGE para un comportamiento de IA actualizado

3. Agregue nuevos controladores de mensajes en mcp_client.py para obtener funcionalidad adicional

Pruebas

Ejecute el cliente de prueba para verificar la funcionalidad de MCP:

python test_client.py

Borrar registros para pruebas:

python clear_logs.py

Seguridad

• Las claves API y la información confidencial se almacenan en .env

• MCP proporciona transmisión segura de mensajes

• Se implementan la validación de entrada y el manejo de errores.

Contribuyendo

1. Bifurcar el repositorio

2. Crear una rama de características

3. Confirme sus cambios

4. Empujar hacia la rama

5. Crear una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.