Supabase MCP Server

Um servidor para consultar e gerenciar dados em um banco de dados Supabase.

GitHub

Documentação

Supabase MCP Server

Este é um servidor Model Context Protocol (MCP) que se conecta ao Supabase e permite consultar a tabela feature_suggestions.

Pré-requisitos

  • Node.js (v16 ou superior)
  • npm
  • Projeto Supabase com credenciais

Configuração

  1. Certifique-se de que seu arquivo .env contém as seguintes credenciais do Supabase:

    SUPABASE_URL=your_supabase_url
SUPABASE_ANON_KEY=your_supabase_anon_key

  2. Instale as dependências necessárias:

    npm install

Executando o Servidor

Execute o servidor MCP usando:

npx tsx mcp-server.ts

Ou use o script npm:

npm run dev

Conectando a Ferramentas de IA

Cursor

  1. Abra o Cursor e navegue até Cursor Settings.
  2. Na aba Features, toque em + Add new MCP server na seção MCP Servers.
  3. Insira os seguintes detalhes:
    • Name: Supabase
    • Type: command
    • Command: npx tsx /path/to/mcp-server.ts
  4. Você deve ver um status ativo verde após o servidor ser conectado com sucesso.

Claude Desktop

  1. Abra o Claude desktop e navegue até Settings.
  2. Na aba Developer, toque em Edit Config para abrir o arquivo de configuração.
  3. Adicione a seguinte configuração: 
    {
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": ["tsx", "/path/to/mcp-server.ts"]
    }
  }
}
  4. Salve o arquivo de configuração e reinicie o Claude desktop.

Ferramentas Disponíveis

query_feature_suggestions

Consulta a tabela feature_suggestions no seu banco de dados Supabase.

Parâmetros:

  • limit (number, opcional): Número máximo de registros a retornar (padrão: 100)

Exemplo de uso em ferramenta de IA:

Can you show me feature suggestions from the database?

Ou com um limite:

Can you show me the top 10 feature suggestions?

Solução de Problemas

  • Se você encontrar problemas de conexão, certifique-se de que suas credenciais do Supabase estão corretas.
  • Verifique a saída do console para mensagens de erro.
  • Garanta que a tabela feature_suggestions exista no seu banco de dados Supabase.