MCP Supabase Server

Este é um servidor MCP (Model Context Protocol) para interagir com o Supabase. Ele permite listar tabelas, consultar dados, inserir, atualizar e deletar registros diretamente através de um cliente MCP como o Trae ou Claude Desktop.

Ferramentas Disponíveis

• list_tables: Lista todas as tabelas no esquema public.
• get_schema: Retorna o esquema (colunas) de uma tabela específica.
• select_data: Seleciona dados de uma tabela com filtros opcionais.
  • tableName (obrigatório): Nome da tabela.
  • columns (opcional): Colunas a selecionar (padrão: *).
  • filter (opcional): Objeto chave-valor para filtrar (ex: {"status": "active"}).
  • limit (opcional): Limite de registros (padrão: 10).
• insert_data: Insere dados em uma tabela.
  • tableName (obrigatório): Nome da tabela.
  • data (obrigatório): Objeto com os dados a inserir.
• update_data: Atualiza dados em uma tabela pelo ID.
  • tableName (obrigatório): Nome da tabela.
  • id (obrigatório): ID do registro.
  • data (obrigatório): Dados a atualizar.
  • idColumn (opcional): Nome da coluna de ID (padrão: id).
• delete_data: Deleta dados de uma tabela pelo ID.
  • tableName (obrigatório): Nome da tabela.
  • id (obrigatório): ID do registro.
  • idColumn (opcional): Nome da coluna de ID (padrão: id).
• run_rpc: Executa uma função RPC (Stored Procedure).
  • functionName (obrigatório): Nome da função.
  • params (opcional): Parâmetros da função.

Instalação

1. Clone este repositório.
2. Instale as dependências:

   npm install
   

3. Compile o projeto:

   npm run build
   

Configuração

O servidor utiliza variáveis de ambiente para conectar ao Supabase.

• SUPABASE_URL: URL do seu projeto Supabase.
• SUPABASE_KEY: Chave de API (anon ou service_role).

Integração com Trae / Claude Desktop

Adicione a seguinte configuração ao seu arquivo de configuração de servidores MCP:

{
  "mcpServers": {
    "supabase": {
      "command": "node",
      "args": ["/caminho/para/mcp-supabase/dist/index.js"],
      "env": {
        "SUPABASE_URL": "sua_url_do_supabase",
        "SUPABASE_KEY": "sua_chave_do_supabase"
      }
    }
  }
}

Para usar via npx (se publicado):

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": ["-y", "mcp-supabase"],
      "env": {
        "SUPABASE_URL": "sua_url_do_supabase",
        "SUPABASE_KEY": "sua_chave_do_supabase"
      }
    }
  }
}

Desenvolvimento

Para rodar em modo de desenvolvimento:

npm run dev