Supabase Next.js Server

supabase-nextjs-server MCP Server

Um servidor Model Context Protocol

Este é um servidor MCP baseado em TypeScript que implementa um sistema simples de notas para NextJS. Ele demonstra conceitos centrais do MCP ao fornecer:

• Recursos que representam notas de texto com URIs e metadados
• Ferramentas para criar novas notas
• Prompts para gerar resumos de notas

Funcionalidades

Inicialização

• Exige as variáveis de ambiente NEXT_PUBLIC_SUPABASE_URL e NEXT_PUBLIC_SUPABASE_ANON_KEY

Recursos

• Liste e acesse notas por meio de URIs note://
• Cada nota possui título, conteúdo e metadados
• Tipo MIME de texto simples para acesso fácil ao conteúdo

Ferramentas

• create_note - Cria novas notas de texto
  • Recebe título e conteúdo como parâmetros obrigatórios
  • Armazena a nota no estado do servidor

Prompts

• summarize_notes - Gera um resumo de todas as notas armazenadas
  • Inclui todo o conteúdo das notas como recursos incorporados
  • Retorna um prompt estruturado para resumo por LLM

Desenvolvimento

Instale as dependências:

npm install

Compile o servidor:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Instalação

Para usar com o Claude Desktop, adicione a configuração do servidor:

No MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json No Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "supabase-nextjs-server": {
      "command": "/path/to/supabase-nextjs-server/build/index.js"
    }
  }
}

Instalação via Smithery

Para instalar o Supabase Notes para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @tengfone/supabase-nextjs-mcp-server --client claude

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector, que está disponível como um script de pacote:

npm run inspector

O Inspector fornecerá uma URL para acessar as ferramentas de depuração no seu navegador.