supabase-nextjs-server MCP Server

What is supabase-nextjs-server?

supabase-nextjs-server is a TypeScript-based Model Context Protocol (MCP) server that implements a simple notes system for NextJS applications. It demonstrates core MCP concepts by providing Resources for text notes, Tools for creating notes, and Prompts for generating summaries of notes. It requires NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY environment variables.

How to use supabase-nextjs-server?

Install dependencies with npm install, build with npm run build, and configure the server in your MCP client (e.g., Claude Desktop) by adding the path to build/index.js in the claude_desktop_config.json. Alternatively, install automatically via Smithery using npx -y @smithery/cli install @tengfone/supabase-nextjs-mcp-server --client claude. Set the required environment variables before running.

Key features of supabase-nextjs-server

• Resources representing text notes with URIs and metadata
• create_note tool for creating new text notes
• summarize_notes prompt for LLM summarization
• Requires NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY
• Built with TypeScript and supports development via npm run watch

Use cases of supabase-nextjs-server

• Manage a simple note‑taking system within a NextJS project
• Integrate note creation and retrieval with MCP‑compatible LLM clients
• Automatically summarize stored notes using an LLM via embedded resources

FAQ from supabase-nextjs-server

What environment variables are required?

You must set NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY before running the server.

How do I list or access notes?

Notes are exposed as resources with URIs of the form note://. You can list and access them through the MCP client.

How do I create a new note?

Use the create_note tool, which takes title and content as required parameters and stores the note in the server state.

How can I get a summary of all notes?

The summarize_notes prompt includes all note contents as embedded resources and returns a structured prompt for LLM summarization.

How can I debug the server?

Use the MCP Inspector by running npm run inspector to get a URL with debugging tools for inspecting stdio communication.