db-mcp-tool

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