Hable con su base de datos mediante MCP

Esta guía explica cómo configurar y ejecutar su servidor MCP para interactuar con su base de datos PostgreSQL mediante Claude Desktop. También debería ser compatible con MySQL, MariaDB y SQLite, ya que utiliza SQLalchemy. Este proyecto se basa en https://github.com/runekaagaard/mcp-alchemy.

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

Prerrequisitos

• Instrucciones de instalación de Docker Compose
• Claude Desktop : Descargar aquí
• uv : Un gestor de paquetes de Python moderno y de alto rendimiento. Si no está instalado, siga las instrucciones a continuación.

1. Configurar variables de entorno

1. Copiar y renombrar el archivo de entorno
   Duplique el archivo .env.example proporcionado y cámbiele el nombre 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. Inicie la base de datos PostgreSQL con datos ficticios

1. Ejecutar Docker Compose
   Asegúrese de que Docker Compose esté instalado y ejecutándose:
   docker-compose up -d
   • Este comando lanzará una base de datos PostgreSQL en localhost:5432 y la completará con datos ficticios.

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

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

5. Configurar y ejecutar el servidor MCP

1. Crear/actualizar la configuración del servidor MCP
   Guarde la siguiente configuración JSON en el archivo de configuración de su servidor MCP (ajuste 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, actualice el valor "command" para reflejar la ruta completa al ejecutable.
2. Iniciar el servidor MCP
   Con la configuración establecida, el servidor MCP se iniciará automáticamente cada vez que se inicie Claude Desktop.

6. Disfruta de tu configuración

• Abra Claude Desktop .
• La herramienta llamará automáticamente a su servidor MCP, lo que le permitirá interactuar con su base de datos sin problemas.

Resumen

1. Configurar variables de entorno : Copie .env.example a .env .
2. Instalar y ejecutar Claude Desktop : Descargar desde Claude Desktop .
3. Inicie PostgreSQL con Docker Compose : ejecute docker-compose up para iniciar la base de datos con datos ficticios.
4. Instalar uv : ejecute el comando de instalación proporcionado si es necesario.
5. Configurar el servidor MCP : actualice el archivo de configuración y asegúrese de que las rutas y las variables de entorno sean correctas.
6. Ejecutar y disfrutar : inicie Claude Desktop para comenzar a interactuar con su base de datos a través de MCP.

Si encuentra algún problema o necesita más ayuda, consulte la documentación correspondiente o comuníquese con su equipo de soporte.

¡Feliz codificación!