Herramienta MCP del explorador de bases de datos

Una poderosa herramienta de Protocolo de Contexto de Modelo (MCP) para explorar y administrar diferentes tipos de bases de datos, incluidos PostgreSQL, MySQL y Firestore.

Características

• Compatibilidad con múltiples bases de datos

  • PostgreSQL

  • MySQL

  • Firestore

• Operaciones de base de datos

  • Conectarse a bases de datos

  • Tablas de listas

  • Ver activadores

  • Funciones de lista

  • Ejecutar consultas SQL (PostgreSQL y MySQL)

  • Exportar esquemas de tablas

  • Exportar datos de la tabla

Integración con Cursor

Antes de agregar la herramienta a Cursor, debe compilar el proyecto:

1. Clonar el repositorio

2. Instalar dependencias:

   npm install

3. Construir el proyecto:

   npm run build

Para agregar la herramienta al Cursor:

1. Abrir la configuración del cursor

2. Vaya a la sección "Protocolo de Contexto de Modelo (MCP)".

3. Haga clic en "Agregar nueva herramienta"

4. Complete los siguientes datos:

   { "name": "database-explorer", "command": "node /path/to/project/dist/index.js", "description": "Database Explorer MCP Tool" }

   Nota: Reemplace /path/to/project con la ruta real al directorio de su proyecto.

5. Guardar la configuración

6. Reiniciar cursor

Usando la herramienta:

1. Después de la configuración, puede conectarse a su base de datos utilizando uno de estos comandos:

   • Para PostgreSQL: utilice !pg con detalles de conexión

   • Para MySQL: utilice !mysql con detalles de conexión

   • Para Firestore: use !firestore con detalles de conexión

2. Una vez conectado, podrá utilizar varias operaciones de base de datos:

   • !tables para listar todas las tablas

   • !triggers para ver los activadores

   • !functions para enumerar funciones

   • !query para ejecutar consultas SQL

   • !export-db para exportar esquemas de tablas

   • !export-data para exportar datos de la tabla

Consulte la sección Comandos a continuación para ver ejemplos de uso detallados.

Comandos

Comandos de conexión

• !pg - Conectarse a la base de datos PostgreSQL

  { "connection": { "host": "hostname", "port": 5432, "database": "dbname", "user": "username", "password": "password" } }

• !mysql - Conectarse a la base de datos MySQL

  { "connection": { "host": "hostname", "port": 3306, "database": "dbname", "user": "username", "password": "password" } }

• !firestore - Conectarse a la base de datos de Firestore

  { "connection": { "projectId": "your-project-id", "keyFilename": "path/to/keyfile.json" } }

Comandos de operación de base de datos

• !tables - Lista todas las tablas en la base de datos conectada

• !triggers - Lista todos los activadores en la base de datos conectada

• !functions - Lista todas las funciones en la base de datos conectada

• !query - Ejecutar consulta SQL (solo PostgreSQL y MySQL)

  { "query": "SELECT * FROM table_name" }

• !export-db - Exportar esquema de tabla

  { "table": "table_name" }

• !export-data - Exportar datos de la tabla como instrucciones INSERT

  { "table": "table_name" }

Requisitos

• Node.js

• Controladores de base de datos necesarios:

  • pg para PostgreSQL

  • mysql2 para MySQL

  • @google-cloud/firestore para Firestore

Uso

1. Asegúrese de tener las credenciales de base de datos necesarias

2. Conéctese a su base de datos utilizando el comando de conexión apropiado

3. Utilice los comandos disponibles para explorar y administrar su base de datos

Manejo de errores

• La herramienta incluye un manejo integral de errores para:

  • Fallos de conexión

  • Errores de ejecución de consultas

  • Problemas de esquema y exportación de datos

  • Operaciones de base de datos no válidas

Notas

• El soporte de Firestore está limitado a operaciones básicas debido a su naturaleza NoSQL

• Las operaciones SQL solo están disponibles para PostgreSQL y MySQL