What is Supabase Nextjs Mcp Server

supabase-nextjs-mcp-server is a TypeScript-based Model Context Protocol server that implements a simple notes system for NextJS. It provides resources for text notes, tools for creating new notes, and prompts for generating summaries of notes.

Use cases

Use cases include personal note-taking applications, collaborative project management tools, and educational platforms where users can create and summarize notes.

How to use

To use supabase-nextjs-mcp-server, set the environment variables NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY. Install dependencies with ‘npm install’, build the server using ‘npm run build’, and for development, use ‘npm run watch’. Configure the server for Claude Desktop by adding it to the appropriate config file.

Key features

Key features include the ability to list and access notes via ‘note://’ URIs, create new notes with ‘create_note’, and generate summaries of all stored notes with ‘summarize_notes’.

Where to use

supabase-nextjs-mcp-server can be used in applications that require a simple note-taking system, educational tools, or any context where managing text notes and summaries is beneficial.

supabase-nextjs-server MCP Server

A Model Context Protocol server

This is a TypeScript-based MCP server that implements a simple notes system for NextJS. It demonstrates core MCP concepts by providing:

• Resources representing text notes with URIs and metadata
• Tools for creating new notes
• Prompts for generating summaries of notes

Features

Init

• Require NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY environment variables

Resources

• List and access notes via note:// URIs
• Each note has a title, content and metadata
• Plain text mime type for simple content access

Tools

• create_note - Create new text notes
  • Takes title and content as required parameters
  • Stores note in server state

Prompts

• summarize_notes - Generate a summary of all stored notes
  • Includes all note contents as embedded resources
  • Returns structured prompt for LLM summarization

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

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

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

Installing via Smithery

To install Supabase Notes for Claude Desktop automatically via Smithery:

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

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.