PostgreSQL & Google Sheets

Servidores MCP para interagir com bancos de dados PostgreSQL e Google Sheets.

GitHubExperimente este MCPPatrocinado

Documentação

Configuração do Servidor MCP

Esta documentação aborda a configuração e as capacidades de múltiplos servidores MCP (Model Context Protocol) para integrações de banco de dados e serviços em nuvem.

1. Configuração dos Servidores MCP PostgreSQL

Abaixo está a configuração MCP para conectar-se a múltiplos bancos de dados 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 Configuração do Servidor MCP PostgreSQL

Os servidores MCP PostgreSQL usam o pacote oficial do 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 Configuração

  • command: "npx" - Executor de pacotes Node que executa pacotes sem instalá-los globalmente
  • args: Array contendo o pacote e os detalhes de conexão
  • Formato da String de Conexão: postgresql://username:password@host:port/database

Ferramentas Disponíveis

O servidor MCP PostgreSQL oficial fornece as seguintes capacidades:

Exploração de Esquema do Banco de Dados

  • list_schemas - Lista todos os esquemas de banco de dados disponíveis na instância PostgreSQL
  • list_tables - Lista objetos do banco de dados (tabelas, views, sequências) dentro de um esquema especificado
  • describe_table - Fornece informações detalhadas sobre uma tabela específica (colunas, restrições, índices)

Execução de Consultas

  • query - Executa consultas SQL SELECT somente leitura com parâmetros opcionais de prepared statement
  • read_query - Execução segura de consultas somente leitura com limitação de resultados e controles de timeout

Gerenciamento de Conexão

  • Pooling e gerenciamento automático de conexões
  • Tratamento seguro de credenciais por meio de strings de conexão
  • Suporte para conexões SSL e recursos avançados do PostgreSQL

Capacidades e Limitações

✅ O que ele PODE fazer:

  • Executar consultas SQL somente leitura (instruções SELECT)
  • Navegar por esquemas de banco de dados e estruturas de tabelas
  • Inspecionar colunas de tabelas, tipos de dados e restrições
  • Visualizar índices e relacionamentos de chaves estrangeiras
  • Suporte para consultas complexas com JOINs, agregações e subconsultas
  • Vinculação de parâmetros de prepared statement para segurança

❌ O que ele NÃO PODE fazer:

  • Executar operações de escrita (INSERT, UPDATE, DELETE, DROP)
  • Modificar o esquema ou a estrutura do banco de dados
  • Criar ou excluir tabelas, índices ou outros objetos de banco de dados
  • Executar stored procedures ou funções
  • Operações administrativas (gerenciamento de usuários, permissões)

Ideal para: Exploração segura de banco de dados, análise de dados, relatórios e consultas de business intelligence somente leitura.

Alternativa Avançada: Postgres MCP Pro

Para ambientes de produção que exigem capacidades mais avançadas, considere o Postgres MCP Pro, que inclui:

  • Verificações de Saúde do Banco de Dados - Analisa a saúde dos índices, utilização de conexões, cache de buffer
  • Ajuste de Índices - Recomendações de índices com IA usando algoritmos de otimização
  • Análise de Desempenho de Consultas - Planos EXPLAIN e sugestões de otimização de consultas
  • Execução Segura de SQL - Modos somente leitura e restritos configuráveis
  • Análise de Carga de Trabalho - Identifica consultas lentas e gargalos de recursos

4. Explicação da Configuração

  • npx: Executor de pacotes Node que executa pacotes sem instalá-los globalmente
  • -y: Confirma automaticamente os prompts e pula a instalação interativa
  • @modelcontextprotocol/server-postgres: O pacote oficial do servidor MCP PostgreSQL
  • Formato da String de Conexão: postgresql://username:password@host:port/database

2. Configuração do Servidor MCP de Documentação LangGraph

O servidor MCP de documentação LangGraph fornece acesso à documentação abrangente para LangGraph e 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 Configuração

  • command: "uvx" - Executor de pacotes Python para executar pacotes do PyPI sem instalação
  • args: Array contendo a especificação do pacote e opções de configuração
  • --from: Especifica o pacote de origem (mcpdoc)
  • --urls: Fontes de documentação no formato "Nome:URL" separadas por espaços
  • --transport: Protocolo de comunicação (stdio para entrada/saída padrão)

Ferramentas Disponíveis

O servidor MCP de documentação LangGraph fornece as seguintes capacidades:

Acesso à Documentação

  • list_doc_sources - Lista todas as fontes de documentação disponíveis e suas URLs
  • fetch_docs - Busca e analisa documentação de URLs específicas ou arquivos locais

Recuperação de Conteúdo

  • Acesso à documentação abrangente do LangGraph cobrindo:
    • Tipos de memória (curto prazo, longo prazo, semântica, episódica, procedural)
    • Arquiteturas de agentes e sistemas multiagentes
    • Construção e execução de grafos
    • Capacidades de streaming e persistência
    • Fluxos de trabalho human-in-the-loop
    • Opções de implantação de plataforma

Busca e Navegação

  • Acesso estruturado às seções da documentação
  • Referências cruzadas entre tópicos relacionados
  • Atualizações de documentação em tempo real de fontes oficiais

Capacidades e Limitações

✅ O que ele PODE fazer:

  • Fornecer explicações detalhadas dos conceitos e recursos do LangGraph
  • Acessar a documentação mais recente de fontes oficiais
  • Explicar padrões de implementação e melhores práticas
  • Oferecer exemplos de código e tutoriais
  • Abranger o uso básico e avançado do LangGraph

❌ O que ele NÃO PODE fazer:

  • Executar ou rodar código LangGraph diretamente
  • Modificar ou atualizar as fontes de documentação
  • Fornecer depuração em tempo real de aplicações LangGraph
  • Acessar fontes de documentação privadas ou personalizadas

Ideal para: Aprender conceitos do LangGraph, entender padrões de implementação, obter explicações detalhadas dos recursos e acessar documentação abrangente para orientação de desenvolvimento.

3. Configuração do Servidor MCP Google Sheets

O servidor MCP Google Sheets é fornecido pela Composio e requer autenticação OAuth:

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

Parâmetros de Configuração

  • url: Endpoint do servidor MCP hospedado pela Composio para integração com Google Sheets
  • customerId: Seu identificador exclusivo de cliente Composio (obtido durante a configuração da conta)
  • agent: Aplicação alvo (cursor para integração com o IDE Cursor)

Ferramentas Disponíveis

Operações Principais de Planilha

  • GOOGLESHEETS_ADD_SHEET - Adiciona novas planilhas/abas à planilha
  • GOOGLESHEETS_DELETE_SHEET - Remove planilhas existentes
  • GOOGLESHEETS_GET_SPREADSHEET_INFO - Obtém metadados da planilha, lista de planilhas, propriedades

Gerenciamento de Linhas/Colunas

  • GOOGLESHEETS_INSERT_DIMENSION - Insere linhas/colunas em posições específicas
  • GOOGLESHEETS_DELETE_DIMENSION - Exclui linhas/colunas especificadas
  • GOOGLESHEETS_APPEND_DIMENSION - Adiciona linhas/colunas ao final

Filtragem e Classificação

  • GOOGLESHEETS_SET_BASIC_FILTER - Aplica filtros e classificação a intervalos de dados
  • GOOGLESHEETS_CLEAR_BASIC_FILTER - Remove filtros existentes

Recursos Avançados

  • GOOGLESHEETS_SEARCH_DEVELOPER_METADATA - Encontra entradas de metadados personalizadas

Gerenciamento de Conexão

  • GOOGLESHEETS_CHECK_ACTIVE_CONNECTION - Verifica o status da autenticação
  • GOOGLESHEETS_INITIATE_CONNECTION - Inicia o processo de autenticação OAuth

Capacidades e Limitações

✅ O que ele PODE fazer:

  • Criar e excluir planilhas/planilhas de trabalho
  • Gerenciar a estrutura da planilha (linhas, colunas)
  • Configurar filtros e classificação
  • Gerenciar metadados da planilha
  • Gerenciamento de autenticação OAuth

❌ O que ele NÃO PODE fazer:

  • Ler ou escrever dados/valores de células
  • Aplicar formatação de células (cores, fontes, bordas)
  • Criar gráficos ou tabelas dinâmicas
  • Lidar com fórmulas de células
  • Operações de dados em lote

Ideal para: Gerenciamento de estrutura de planilhas, criação de modelos e configuração de organização de dados.

5. Serviços Conectados

Bancos de Dados

  1. bi_chatbot: Conjunto de dados de e-commerce Olist com 8 tabelas (clientes, pedidos, produtos, etc.)
  2. airbnb: Conjunto de dados Airbnb para análise

Serviços em Nuvem

  1. Google Sheets: Gerenciamento de planilhas e operações de estrutura

Serviços de Documentação

  1. Documentação LangGraph: Acesso abrangente à documentação para os frameworks LangGraph e LangChain

6. Uso

Após a configuração, reinicie o Cursor para habilitar os servidores MCP. Cada banco de dados terá sua própria ferramenta de consulta disponível na interface de chat.

Requisitos de Autenticação

Servidores PostgreSQL

  • Credenciais pré-configuradas por meio de strings de conexão no mcp.json
  • Conexão automática - Nenhuma configuração adicional necessária após a configuração
  • Conexões seguras - Suporta SSL e métodos avançados de autenticação PostgreSQL

Servidor Google Sheets

  • Autenticação OAuth necessária - Configuração única baseada em navegador
  • Autorização no navegador - Abre URL de redirecionamento para acesso à conta Google
  • Sessões persistentes - A autenticação persiste entre reinicializações do cliente MCP