Talk with Your Database

Interactúa con bases de datos PostgreSQL, MySQL, MariaDB y SQLite usando SQLAlchemy.

GitHub
1
Prueba este MCPPatrocinado

Documentación

Habla con tu base de datos usando MCP

Talk with Your Database Using MCP

Esta guía explica cómo configurar y ejecutar tu servidor MCP para interactuar con tu base de datos PostgreSQL usando Claude Desktop. También debería funcionar con MySQL, MariaDB, SQLite, ya que utiliza sqlalchemy internamente. Este proyecto está construido sobre https://github.com/runekaagaard/mcp-alchemy

Nota: Esta guía asume que tienes un conocimiento básico de Docker, variables de entorno y uso de la CLI.

Requisitos previos

1. Configurar variables de entorno

  1. Copiar y renombrar el archivo de entorno
    Duplica el archivo .env.example proporcionado y renómbralo a .env: 
    cp .env.example .env

2. Configurar Claude Desktop

  1. Descargar e instalar Claude Desktop
    Visita la página de descarga de Claude Desktop e instala la aplicación.

3. Iniciar la base de datos PostgreSQL con datos de prueba

  1. Ejecutar Docker Compose
    Asegúrate de que Docker Compose esté instalado y ejecuta: 
    docker-compose up -d
    • Este comando iniciará una base de datos PostgreSQL en localhost:5432 y la poblará con datos de prueba.

4. Instalar uv (si aún no está instalado)

  1. Instalar uv
    Ejecuta el siguiente comando para instalar uv: 
    curl -LsSf https://astral.sh/uv/install.sh | sh

5. Configurar e iniciar el servidor MCP

  1. Crear/Actualizar la configuración del servidor MCP
    Guarda la siguiente configuración JSON en tu archivo de configuración del servidor MCP (ajusta las rutas si es necesario):

    {
  "mcpServers": {
    "my_database": {
      "command": "uv",
      "args": [
        "--directory",
        "/directory/where/this/app/is/located/app/",
        "run",
        "server.py"
      ],
      "env": {
        "DB_URL": "postgresql://postgres:password@localhost:5432/mydatabase"
      }
    }
  }
}
    • Consejo: Si uv está instalado en una ubicación no estándar, actualiza el valor de "command" para reflejar la ruta completa al ejecutable.

  2. Iniciar el servidor MCP
    Con la configuración en su lugar, el servidor MCP se iniciará automáticamente cada vez que se lance Claude Desktop.

6. Disfruta tu configuración

  • Abre Claude Desktop.
  • La herramienta llamará automáticamente a tu servidor MCP, permitiéndote interactuar con tu base de datos sin problemas.

Resumen

  1. Configurar variables de entorno: Copia .env.example a .env.
  2. Instalar y ejecutar Claude Desktop: Descarga desde Claude Desktop.
  3. Iniciar PostgreSQL con Docker Compose: Ejecuta docker-compose up para iniciar la base de datos con datos de prueba.
  4. Instalar uv: Ejecuta el comando de instalación proporcionado si es necesario.
  5. Configurar el servidor MCP: Actualiza el archivo de configuración y asegúrate de que las rutas y las variables de entorno sean correctas.
  6. Iniciar y disfrutar: Inicia Claude Desktop para comenzar a interactuar con tu base de datos a través de MCP.

Si encuentras algún problema o necesitas más ayuda, consulta la documentación relevante o contacta con tu equipo de soporte.

¡Feliz codificación!