Integrates with Ollama to provide local LLM capabilities (using Llama 3 or other compatible models) for processing natural language queries and responding to free-form conversation.
Manages user data in a PostgreSQL database, supporting CRUD operations (add, delete, modify, query) for user profiles with details like names and email addresses.
Provides a web-based chat interface built with Streamlit, allowing users to interact with the system through natural language commands for database operations and free conversation.
MCP Server Demo con Streamlit y Ollama
Este proyecto es una demo de un servidor MCP (Model Context Protocol) en Python, integrado con una interfaz de chat web hecha en Streamlit y un modelo de lenguaje local usando Ollama. Permite gestionar usuarios en una base de datos PostgreSQL (agregar, eliminar, modificar, consultar) tanto desde el chat como desde herramientas MCP externas.
Características
- Chat web con Streamlit.
- LLM local usando Ollama (Llama 3 u otro modelo compatible).
- Servidor MCP con herramientas para CRUD de usuarios.
- Base de datos PostgreSQL para almacenar usuarios.
- Integración flexible: puedes usar solo el chat, solo el servidor MCP, o ambos.
Requisitos
- Python 3.9+
- PostgreSQL corriendo y accesible
- Ollama instalado y corriendo (para LLM local)
- Entorno virtual (recomendado)
- Las dependencias del archivo
requirements.txt
Instalación
- Clona el repositorio:
- Crea y activa un entorno virtual:
- Instala las dependencias:
- Configura tu base de datos PostgreSQL y ajusta los datos de conexión en
server.py
. - (Opcional) Crea un archivo
.env
si usas claves de API.
Uso
1. Levanta Ollama y el modelo LLM
2. Levanta el chat de Streamlit
Abre el navegador en http://localhost:8501.
3. (Opcional) Levanta el servidor MCP
o
Funcionalidades del chat
- Agregar usuario:
Escribe:agregar usuario Juan juan@mail.com clave123
- Eliminar usuario:
Escribe:eliminar usuario juan@mail.com
- Modificar usuario:
Escribe:modificar usuario juan@mail.com nombre=Juan Perez contraseña=nuevaClave
- Consultar usuarios:
Escribe:consultar usuarios
oconsultar usuario juan@mail.com
- Conversación libre:
Si el mensaje no es una acción, responde la LLM local.
Créditos
¡Contribuciones y sugerencias son bienvenidas!
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
A Python-based Model Context Protocol server with Streamlit chat interface that allows users to manage a PostgreSQL database through both web UI and MCP tools, powered by Ollama for local LLM integration.
Related MCP Servers
- -securityFlicense-qualityAn interactive chat interface that combines Ollama's LLM capabilities with PostgreSQL database access through the Model Context Protocol (MCP). Ask questions about your data in natural language and get AI-powered responses backed by real SQL queries.Last updated -28TypeScript
- -securityFlicense-qualityA Model Context Protocol server providing both read and write access to PostgreSQL databases, enabling LLMs to query data, modify records, and manage database schemas.Last updated -4JavaScript
- -securityAlicense-qualityA Model Context Protocol server that enables powerful PostgreSQL database management capabilities including analysis, schema management, data migration, and monitoring through natural language interactions.Last updated -5821TypeScriptAGPL 3.0
- -securityFlicense-qualityA Model Context Protocol server that enables performing PostgreSQL database operations (create, read, update, delete) on User and Post entities through MCP tools.Last updated -TypeScript