Servidor MCP do Supabase

Este é um servidor MCP (Model-Controller-Persistence) que fornece uma API RESTful para interagir com o Supabase.

Funcionalidades

• Consulta de dados de tabelas
• Consulta de registros específicos
• Inserção de dados
• Atualização de dados

Configuração Local

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

   npm install
   

3. Copie o arquivo .env.example para .env e preencha com suas credenciais do Supabase:

   cp .env.example .env
   

Deploy na Smithery

1. Instale a CLI da Smithery:

   npm install -g @smithery/cli
   

2. Faça login na sua conta Smithery:

   smithery login
   

3. No diretório do projeto, inicialize o deploy:

   smithery deploy
   

4. Configure as variáveis de ambiente no painel da Smithery:

   • SUPABASE_URL: URL do seu projeto Supabase
   • SUPABASE_KEY: Chave de API do seu projeto Supabase

5. Seu servidor estará disponível no domínio fornecido pela Smithery após o deploy.

Uso Local

Para iniciar o servidor localmente:

npm start

Endpoints

• GET /api/:table - Lista todos os registros de uma tabela

  • Query params:
    • select: campos a serem retornados (opcional)

• GET /api/:table/:id - Obtém um registro específico por ID

• POST /api/:table - Insere um novo registro

  • Body: objeto com os dados a serem inseridos

• PATCH /api/:table/:id - Atualiza um registro existente

  • Body: objeto com os campos a serem atualizados

Exemplos de Uso

Listar todos os registros de uma tabela

curl http://localhost:3000/api/users

Listar registros com campos específicos

curl http://localhost:3000/api/users?select=id,name,email

Obter um registro específico

curl http://localhost:3000/api/users/123

Inserir um novo registro

curl -X POST http://localhost:3000/api/users \
  -H "Content-Type: application/json" \
  -d '{"name": "João", "email": "joao@exemplo.com"}'

Atualizar um registro

curl -X PATCH http://localhost:3000/api/users/123 \
  -H "Content-Type: application/json" \
  -d '{"name": "João Silva"}'

Monitoramento na Smithery

Após o deploy, você pode monitorar seu servidor através do painel da Smithery:

1. Acesse o painel da Smithery
2. Navegue até seu projeto
3. Visualize:
   • Logs em tempo real
   • Métricas de uso
   • Status do servidor
   • Variáveis de ambiente