PostgreSQL & Google Sheets

Servidores MCP para interactuar con bases de datos PostgreSQL y Google Sheets.

GitHubPrueba este MCPPatrocinado

Documentación

Configuración del Servidor MCP

Esta documentación cubre la configuración y las capacidades de múltiples servidores MCP (Model Context Protocol) para integraciones de bases de datos y servicios en la nube.

1. Configuración de Servidores MCP de PostgreSQL

A continuación se muestra la configuración de MCP para conectarse a múltiples bases de datos PostgreSQL:

{
  "mcpServers": {
    // MCP server for bi_chatbot database - provides SQL query capabilities
    "postgres-bi-chatbot": {
      "command": "npx", // Node package executor to run packages without installing
      "args": [
        "-y", // Auto-confirm prompts, skip interactive installation
        "@modelcontextprotocol/server-postgres", // MCP PostgreSQL server package
        "postgresql://postgres:cikalmerdeka@localhost:5432/bi_chatbot" // Connection string: protocol://user:password@host:port/database
      ]
    },
    // MCP server for airbnb database - provides SQL query capabilities
    "postgres-airbnb": {
      "command": "npx", // Node package executor to run packages without installing
      "args": [
        "-y", // Auto-confirm prompts, skip interactive installation
        "@modelcontextprotocol/server-postgres", // MCP PostgreSQL server package
        "postgresql://postgres:cikalmerdeka@localhost:5432/airbnb" // Connection string: protocol://user:password@host:port/database
      ]
    },
    // MCP server for Google Sheets - provides spreadsheet management capabilities
    "googlesheets": {
      "url": "https://mcp.composio.dev/partner/composio/googlesheets/mcp?customerId=YOUR_CUSTOMER_ID&agent=cursor" // Composio Google Sheets MCP endpoint with OAuth integration
    }
  }
}

1.1 Configuración del Servidor MCP de PostgreSQL

Los servidores MCP de PostgreSQL utilizan el paquete oficial del Model Context Protocol:

"postgres-bi-chatbot": {
  "command": "npx", // Node package executor to run packages without installing
  "args": [
    "-y", // Auto-confirm prompts, skip interactive installation
    "@modelcontextprotocol/server-postgres", // MCP PostgreSQL server package
    "postgresql://postgres:cikalmerdeka@localhost:5432/bi_chatbot" // Connection string: protocol://user:password@host:port/database
  ]
}

Parámetros de Configuración

  • command: "npx" - Ejecutor de paquetes de Node que ejecuta paquetes sin instalarlos globalmente
  • args: Matriz que contiene el paquete y los detalles de conexión
  • Formato de Cadena de Conexión: postgresql://username:password@host:port/database

Herramientas Disponibles

El servidor MCP oficial de PostgreSQL proporciona las siguientes capacidades:

Exploración de Esquemas de Base de Datos

  • list_schemas - Lista todos los esquemas de base de datos disponibles en la instancia de PostgreSQL
  • list_tables - Lista los objetos de la base de datos (tablas, vistas, secuencias) dentro de un esquema especificado
  • describe_table - Proporciona información detallada sobre una tabla específica (columnas, restricciones, índices)

Ejecución de Consultas

  • query - Ejecuta consultas SQL SELECT de solo lectura con parámetros opcionales de declaraciones preparadas
  • read_query - Ejecución segura de consultas de solo lectura con límites de resultados y controles de tiempo de espera

Gestión de Conexiones

  • Agrupación y gestión automática de conexiones
  • Manejo seguro de credenciales a través de cadenas de conexión
  • Soporte para conexiones SSL y características avanzadas de PostgreSQL

Capacidades y Limitaciones

✅ Lo que PUEDE hacer:

  • Ejecutar consultas SQL de solo lectura (sentencias SELECT)
  • Explorar esquemas de bases de datos y estructuras de tablas
  • Inspeccionar columnas de tablas, tipos de datos y restricciones
  • Ver índices y relaciones de claves foráneas
  • Soporte para consultas complejas con JOINs, agregaciones y subconsultas
  • Vinculación de parámetros de declaraciones preparadas para seguridad

❌ Lo que NO PUEDE hacer:

  • Ejecutar operaciones de escritura (INSERT, UPDATE, DELETE, DROP)
  • Modificar el esquema o la estructura de la base de datos
  • Crear o eliminar tablas, índices u otros objetos de base de datos
  • Ejecutar procedimientos almacenados o funciones
  • Operaciones administrativas (gestión de usuarios, permisos)

Ideal para: Exploración segura de bases de datos, análisis de datos, informes y consultas de inteligencia empresarial de solo lectura.

Alternativa Avanzada: Postgres MCP Pro

Para entornos de producción que requieren capacidades más avanzadas, considere Postgres MCP Pro que incluye:

  • Comprobaciones de Salud de la Base de Datos - Analiza la salud de los índices, la utilización de conexiones, la caché de búfer
  • Ajuste de Índices - Recomendaciones de índices impulsadas por IA utilizando algoritmos de optimización
  • Análisis de Rendimiento de Consultas - Planes EXPLAIN y sugerencias de optimización de consultas
  • Ejecución Segura de SQL - Modos de solo lectura y restringidos configurables
  • Análisis de Carga de Trabajo - Identifica consultas lentas y cuellos de botella de recursos

4. Explicación de la Configuración

  • npx: Ejecutor de paquetes de Node que ejecuta paquetes sin instalarlos globalmente
  • -y: Confirma automáticamente las indicaciones y omite la instalación interactiva
  • @modelcontextprotocol/server-postgres: El paquete oficial del servidor MCP de PostgreSQL
  • Formato de Cadena de Conexión: postgresql://username:password@host:port/database

2. Configuración del Servidor MCP de Documentación de LangGraph

El servidor MCP de documentación de LangGraph proporciona acceso a documentación completa para LangGraph y LangChain:

"langgraph-docs-mcp": {
  "command": "uvx", // Python package runner that executes packages from PyPI
  "args": [
    "--from", // Specify the package to install from
    "mcpdoc", // Package name containing the MCP documentation server
    "mcpdoc", // Command to run from the package
    "--urls", // Documentation sources to index
    "LangGraph:https://langchain-ai.github.io/langgraph/llms.txt LangChain:https://python.langchain.com/llms.txt", // Space-separated list of documentation URLs
    "--transport", // Communication protocol
    "stdio" // Standard input/output transport
  ]
}

Parámetros de Configuración

  • command: "uvx" - Ejecutor de paquetes de Python para ejecutar paquetes desde PyPI sin instalación
  • args: Matriz que contiene la especificación del paquete y las opciones de configuración
  • --from: Especifica el paquete fuente (mcpdoc)
  • --urls: Fuentes de documentación en formato "Nombre:URL" separadas por espacios
  • --transport: Protocolo de comunicación (stdio para entrada/salida estándar)

Herramientas Disponibles

El servidor MCP de documentación de LangGraph proporciona las siguientes capacidades:

Acceso a Documentación

  • list_doc_sources - Lista todas las fuentes de documentación disponibles y sus URLs
  • fetch_docs - Obtiene y analiza documentación de URLs específicas o archivos locales

Recuperación de Contenido

  • Acceso a documentación completa de LangGraph que cubre:
    • Tipos de memoria (corto plazo, largo plazo, semántica, episódica, procedimental)
    • Arquitecturas de agentes y sistemas multiagente
    • Construcción y ejecución de grafos
    • Capacidades de streaming y persistencia
    • Flujos de trabajo con intervención humana
    • Opciones de despliegue de plataforma

Búsqueda y Navegación

  • Acceso estructurado a secciones de documentación
  • Referencias cruzadas entre temas relacionados
  • Actualizaciones de documentación en tiempo real desde fuentes oficiales

Capacidades y Limitaciones

✅ Lo que PUEDE hacer:

  • Proporcionar explicaciones detalladas de conceptos y características de LangGraph
  • Acceder a la documentación más reciente de fuentes oficiales
  • Explicar patrones de implementación y mejores prácticas
  • Ofrecer ejemplos de código y tutoriales
  • Cubrir tanto el uso básico como avanzado de LangGraph

❌ Lo que NO PUEDE hacer:

  • Ejecutar o ejecutar código de LangGraph directamente
  • Modificar o actualizar las fuentes de documentación
  • Proporcionar depuración en tiempo real de aplicaciones LangGraph
  • Acceder a fuentes de documentación privadas o personalizadas

Ideal para: Aprender conceptos de LangGraph, comprender patrones de implementación, obtener explicaciones detalladas de características y acceder a documentación completa para orientación de desarrollo.

3. Configuración del Servidor MCP de Google Sheets

El servidor MCP de Google Sheets es proporcionado por Composio y requiere autenticación OAuth:

"googlesheets": {
  "url": "https://mcp.composio.dev/partner/composio/googlesheets/mcp?customerId=YOUR_CUSTOMER_ID&agent=cursor"
}

Parámetros de Configuración

  • url: Punto final del servidor MCP alojado por Composio para la integración de Google Sheets
  • customerId: Su identificador único de cliente de Composio (obtenido durante la configuración de la cuenta)
  • agent: Aplicación objetivo (cursor para integración con Cursor IDE)

Herramientas Disponibles

Operaciones Principales de Hojas de Cálculo

  • GOOGLESHEETS_ADD_SHEET - Agregar nuevas hojas de trabajo/pestañas a la hoja de cálculo
  • GOOGLESHEETS_DELETE_SHEET - Eliminar hojas existentes
  • GOOGLESHEETS_GET_SPREADSHEET_INFO - Obtener metadatos de la hoja de cálculo, lista de hojas, propiedades

Gestión de Filas/Columnas

  • GOOGLESHEETS_INSERT_DIMENSION - Insertar filas/columnas en posiciones específicas
  • GOOGLESHEETS_DELETE_DIMENSION - Eliminar filas/columnas especificadas
  • GOOGLESHEETS_APPEND_DIMENSION - Agregar filas/columnas al final

Filtrado y Ordenamiento

  • GOOGLESHEETS_SET_BASIC_FILTER - Aplicar filtros y ordenamiento a rangos de datos
  • GOOGLESHEETS_CLEAR_BASIC_FILTER - Eliminar filtros existentes

Características Avanzadas

  • GOOGLESHEETS_SEARCH_DEVELOPER_METADATA - Buscar entradas de metadatos personalizados

Gestión de Conexiones

  • GOOGLESHEETS_CHECK_ACTIVE_CONNECTION - Verificar el estado de autenticación
  • GOOGLESHEETS_INITIATE_CONNECTION - Iniciar el proceso de autenticación OAuth

Capacidades y Limitaciones

✅ Lo que PUEDE hacer:

  • Crear y eliminar hojas/hojas de trabajo
  • Gestionar la estructura de la hoja (filas, columnas)
  • Configurar filtros y ordenamiento
  • Manejar metadatos de hojas de cálculo
  • Gestión de autenticación OAuth

❌ Lo que NO PUEDE hacer:

  • Leer o escribir datos/valores de celdas
  • Aplicar formato de celdas (colores, fuentes, bordes)
  • Crear gráficos o tablas dinámicas
  • Manejar fórmulas de celdas
  • Operaciones de datos por lotes

Ideal para: Gestión de estructura de hojas de cálculo, creación de plantillas y configuración de organización de datos.

5. Servicios Conectados

Bases de Datos

  1. bi_chatbot: Conjunto de datos de comercio electrónico de Olist con 8 tablas (clientes, pedidos, productos, etc.)
  2. airbnb: Conjunto de datos de Airbnb para análisis

Servicios en la Nube

  1. Google Sheets: Gestión de hojas de cálculo y operaciones de estructura

Servicios de Documentación

  1. Documentación de LangGraph: Acceso completo a documentación para los marcos de trabajo LangGraph y LangChain

6. Uso

Después de la configuración, reinicie Cursor para habilitar los servidores MCP. Cada base de datos tendrá su propia herramienta de consulta disponible en la interfaz de chat.

Requisitos de Autenticación

Servidores PostgreSQL

  • Credenciales preconfiguradas a través de cadenas de conexión en mcp.json
  • Conexión automática - No se requiere configuración adicional después de la configuración
  • Conexiones seguras - Soporta SSL y métodos avanzados de autenticación de PostgreSQL

Servidor de Google Sheets

  • Autenticación OAuth requerida - Configuración única basada en navegador
  • Autorización del navegador - Abre URL de redirección para acceso a la cuenta de Google
  • Sesiones persistentes - La autenticación persiste entre reinicios del cliente MCP