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
- Clone o repositório
- Instale as dependências:
npm install
- Copie o arquivo
.env.example
para.env
e preencha com suas credenciais do Supabase:cp .env.example .env
Deploy na Smithery
-
Instale a CLI da Smithery:
npm install -g @smithery/cli
-
Faça login na sua conta Smithery:
smithery login
-
No diretório do projeto, inicialize o deploy:
smithery deploy
-
Configure as variáveis de ambiente no painel da Smithery:
SUPABASE_URL
: URL do seu projeto SupabaseSUPABASE_KEY
: Chave de API do seu projeto Supabase
-
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)
- Query params:
-
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": "[email protected]"}'
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:
- Acesse o painel da Smithery
- Navegue até seu projeto
- Visualize:
- Logs em tempo real
- Métricas de uso
- Status do servidor
- Variáveis de ambiente