Ollama MCP Database Assistant

Asistente de base de datos Ollama MCP

Una interfaz de chat interactiva que combina las capacidades LLM de Ollama con el acceso a bases de datos PostgreSQL mediante el Protocolo de Contexto de Modelo (MCP). Pregunte sobre sus datos en lenguaje natural y obtenga respuestas basadas en IA, respaldadas por consultas SQL reales.

Características

• Interfaz de lenguaje natural para su base de datos PostgreSQL
• Generación automática de consultas SQL
• Respuestas que tienen en cuenta el esquema
• Interfaz de chat interactiva
• Acceso seguro y de solo lectura a la base de datos

Prerrequisitos

• Node.js 16 o superior
• Una base de datos PostgreSQL en ejecución
• Ollama instalado y ejecutándose localmente
• El modelo qwen2.5-coder:7b-instruct incluido en Ollama

Configuración

1. Clonar el repositorio:

2. Instalar dependencias:

3. Extraiga el modelo Ollama requerido:

4. Cree un archivo .env en la raíz del proyecto:

Uso

1. Iniciar la interfaz de chat:

2. Haga preguntas sobre sus datos en lenguaje natural:

3. Escriba ‘exit’ para salir de la aplicación.

Cómo funciona

1. La aplicación se conecta a su base de datos PostgreSQL a través del servidor PostgreSQL MCP
2. Carga y almacena en caché el esquema de su base de datos.
3. Cuando haces una pregunta:
   • El esquema y la pregunta se envían a Ollama
   • Ollama genera una consulta SQL apropiada
   • La consulta se ejecuta a través de MCP
   • Los resultados se envían a Ollama para su interpretación.
   • Recibirás una respuesta en lenguaje natural

Variables de entorno

Seguridad

• Todo acceso a la base de datos es de sólo lectura.
• Las consultas SQL están restringidas a sentencias SELECT
• Las credenciales de la base de datos se mantienen seguras en su archivo .env

Desarrollo

Construido con:

• Mecanografiado
• Protocolo de Contexto Modelo (MCP)
• Ollama
• PostgreSQL

Solución de problemas

Problemas comunes

1. "Error al conectar con la base de datos"
   • Comprueba tu DATABASE_URL en .env
   • Verificar que PostgreSQL se esté ejecutando
   • Comprobar la conectividad de la red
2. "Error al conectar con Ollama"
   • Asegúrese de que Ollama se esté ejecutando ( ollama serve )
   • Verificar que el modelo esté instalado ( ollama list )
3. "Error al ejecutar la consulta"
   • Comprobar los permisos de la base de datos
   • Verificar los nombres de tablas/columnas en el esquema

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuyendo

1. Bifurcar el repositorio
2. Crea tu rama de funciones
3. Confirme sus cambios
4. Empujar hacia la rama
5. Abrir una solicitud de extracción