Skip to main content
Glama
hmmatus

MCP Usuarios DB

by hmmatus
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

MCP Usuarios DB

Sistema de gestión de usuarios con PostgreSQL, expuesto de tres formas:

  1. Servidor MCP — integración con ChatGPT/OpenAI (herramientas de función)

  2. API REST — Flask + Gunicorn

  3. App web — HTML/CSS/JS con búsqueda por voz (Whisper + TTS)

Todo corre en un solo docker-compose.yml con base de datos compartida.

Arquitectura

┌─────────────────────────────────────────────────────────────┐
│                     docker-compose.yml                       │
├──────────────┬──────────────────┬───────────────────────────┤
│   postgres   │    mcp-server    │         mcp-api           │
│  PostgreSQL  │  app/server.py   │      app/api.py           │
│   :5433      │  (MCP + OpenAI)  │  Flask + web/static       │
│              │                  │       :5001               │
└──────┬───────┴────────┬─────────┴───────────┬───────────────┘
       │                │                     │
       └────────────────┴─────────────────────┘
                    usuarios_db

Related MCP server: Enterprise Data MCP Server

Estructura del proyecto

mcp-db/
├── app/
│   ├── __init__.py
│   ├── api.py              # API REST Flask + rutas de voz
│   ├── database.py           # Conexión PostgreSQL y CRUD
│   ├── models.py             # Modelos Usuario y EstadisticasUsuarios
│   ├── server.py             # Servidor MCP para ChatGPT
│   └── voice.py              # Whisper, TTS e interpretación de comandos
├── web/static/
│   ├── index.html            # Interfaz web
│   ├── style.css             # Estilos
│   ├── script.js             # Lógica UI (búsqueda, crear, stats)
│   └── voice.js              # Grabación, permisos micrófono, voz
├── db/
│   ├── init.sql              # Esquema tabla usuarios
│   └── seed.sql              # ~1000 usuarios de prueba
├── docker-compose.yml        # postgres + mcp-server + mcp-api
├── Dockerfile                # Imagen MCP server
├── Dockerfile-web            # Imagen API web
├── requirements.txt          # Deps MCP (openai, psycopg2)
├── requirements-web.txt      # Deps web (flask, gunicorn, openai)
├── .env.example              # Variables de entorno de ejemplo
└── README.md

Requisitos

  • Docker y Docker Compose

  • Cuenta OpenAI con API key (MCP + voz)

Configuración

  1. Clona el repositorio:

git clone https://github.com/hmmatus/mcp-db.git
cd mcp-db

  1. Crea el archivo .env desde el ejemplo:

cp .env.example .env

  1. Edita .env y agrega tu clave de OpenAI:

OPENAI_API_KEY=sk-tu-clave-aqui

Las variables de PostgreSQL ya están configuradas en docker-compose.yml para Docker. Para desarrollo local fuera de Docker usa DB_PORT=5433.

Ejecutar con Docker

Levantar todos los servicios:

docker compose up -d

Solo base de datos y API web:

docker compose up -d postgres mcp-api

Ver logs:

docker compose logs -f mcp-api

Detener:

docker compose down

URLs y puertos

Servicio

URL / Puerto

Descripción

Web + API

http://localhost:5001

Interfaz y REST API

PostgreSQL

localhost:5433

BD (usuario: mcpuser)

MCP server

(stdin, sin puerto HTTP)

Para integración con Cursor/IDE

Nota macOS: el puerto 5000 suele estar ocupado por AirPlay. La API web usa 5001 en el host.

API REST

Base: http://localhost:5001/api

Método

Ruta

Descripción

GET

/usuarios?limite=10&offset=0

Listar usuarios

GET

/usuarios/<id>

Usuario por ID

POST

/usuarios

Crear usuario

PUT

/usuarios/<id>

Actualizar usuario

DELETE

/usuarios/<id>

Borrado lógico

GET

/search/email?email=

Buscar por email

GET

/search/nombre?nombre=

Buscar por nombre

GET

/search/ciudad?ciudad=

Buscar por ciudad

GET

/search/edad?edad_minima=&edad_maxima=

Buscar por edad

GET

/estadisticas

Estadísticas globales

GET

/health

Health check

POST

/voice/transcribe

Audio → texto (Whisper)

POST

/voice/procesar-comando

Interpretar comando de voz

POST

/voice/sintetizar

Texto → audio (TTS)

Respuesta estándar:

{
  "exito": true,
  "datos": {},
  "error": null,
  "cantidad": 10,
  "mensaje": "Usuario creado"
}

App web

Abre http://localhost:5001 en el navegador.

Secciones

  • Voz — mantén presionado el micrófono, habla un comando, escucha la respuesta

  • Inicio — últimos usuarios registrados

  • Buscar — por email, nombre, ciudad o rango de edad

  • Crear — formulario de nuevo usuario

  • Estadísticas — totales, edad promedio, ciudades y países

Comandos de voz (ejemplos)

  • "Busca usuarios en San Salvador"

  • "Dame los usuarios entre 25 y 35 años"

  • "Busca a Juan"

  • "Crea un usuario llamado Carlos con email carlos@mail.com"

  • "Cuántos usuarios hay en total?"

  • "Elimina el usuario 5"

Al entrar, la app solicita permiso de micrófono con una explicación de uso.

Servidor MCP (ChatGPT)

El servicio mcp-server ejecuta python -m app.server y expone herramientas OpenAI para consultar y modificar usuarios.

Requiere OPENAI_API_KEY en .env. Se usa con clientes MCP compatibles (Cursor, Claude Desktop, etc.).

docker compose up -d mcp-server
docker attach mcp-server   # modo interactivo

Desarrollo local (sin Docker)

API web

pip install -r requirements-web.txt
export DB_HOST=localhost DB_PORT=5433 DB_USER=mcpuser DB_PASSWORD=mcppassword DB_NAME=usuarios_db
export OPENAI_API_KEY=sk-...
python -m app.api

Solo PostgreSQL en Docker

docker compose up -d postgres

Base de datos

Tabla usuarios:

Campo

Tipo

id

SERIAL PK

nombre

VARCHAR(100)

email

VARCHAR(100) UNIQUE

edad

INTEGER

ciudad, pais

VARCHAR(100)

telefono

VARCHAR(20)

activo

BOOLEAN (default true)

created_at, updated_at

TIMESTAMP

Conectar con psql:

psql -h localhost -p 5433 -U mcpuser -d usuarios_db
# password: mcppassword

Variables de entorno

Variable

Descripción

Default (Docker)

OPENAI_API_KEY

Clave OpenAI (MCP + voz)

—

DB_HOST

Host PostgreSQL

postgres

DB_PORT

Puerto PostgreSQL

5432 (contenedor) / 5433 (host)

DB_USER

Usuario BD

mcpuser

DB_PASSWORD

Contraseña BD

mcppassword

DB_NAME

Nombre BD

usuarios_db

Licencia

MIT

This server cannot be installed

F
license - not found
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hmmatus/mcp-db'

If you have feedback or need assistance with the MCP directory API, please join our Discord server