Neon Auth MCP OAuth

@andrelandgraf

About Neon Auth MCP OAuth

PoC of an MCP server in a Next.js app with Neon Auth and custom OAuth flow for MCP.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "echo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://neon-auth-mcp-oauth-6zf3o859s-andrelandgraf.vercel.app"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Neon Auth MCP OAuth?

A proof-of-concept implementation of a custom MCP OAuth flow built with Next.js, Neon, Upstash Redis, and Neon Auth. It is designed for developers who want to experiment with MCP authentication using Neon Auth and OAuth.

How to use Neon Auth MCP OAuth?

Add the provided MCP configuration to Cursor, Windsurf, Claude Desktop, or any MCP client. For local development, replace the URL in the config with http://localhost:3000/api/v1/mcp and run npm run dev.

Key features of Neon Auth MCP OAuth

Custom MCP OAuth flow implementation
Built with Next.js, Neon, Upstash Redis, and Neon Auth
Deployable to Vercel with Upstash Redis integration
Debugging support via MCP Inspector
Includes a development server for local testing

Use cases of Neon Auth MCP OAuth

Experimenting with MCP OAuth authentication in a Next.js environment
Integrating Neon Auth with MCP clients like Cursor, Windsurf, or Claude Desktop
Prototyping custom OAuth workflows for MCP servers
Learning how to combine Neon, Upstash Redis, and Neon Auth for MCP

FAQ from Neon Auth MCP OAuth

What is this project?

It is a proof of concept (PoC) for a custom MCP OAuth flow using Next.js, Neon, Upstash Redis, and Neon Auth.

What are the dependencies and runtime requirements?

You need to set up a Neon database and Neon Auth, deploy to Vercel, and configure Upstash Redis via the Vercel Upstash Integration. Environment variables are required (see ./lib/config.ts).

How do I reset auth state if I run into issues?

Run rm -rf ~/.mcp-auth to clear stored authentication data from the mcp-remote package. MCP auth is noted as still flaky.

Can I run this locally?

Yes, clone the repository, set up the environment, and run npm run dev. Use npm run playground to start the MCP Inspector for debugging.

What transports or authentication does it use?

It uses a custom OAuth flow over HTTP/HTTPS (the MCP server endpoint is /api/v1/mcp). Authentication is handled via Neon Auth and OAuth tokens.

Frequently asked questions

What is this project?

It is a proof of concept (PoC) for a custom MCP OAuth flow using Next.js, Neon, Upstash Redis, and Neon Auth.

What are the dependencies and runtime requirements?

You need to set up a Neon database and Neon Auth, deploy to Vercel, and configure Upstash Redis via the Vercel Upstash Integration. Environment variables are required (see `./lib/config.ts`).

How do I reset auth state if I run into issues?

Run `rm -rf ~/.mcp-auth` to clear stored authentication data from the `mcp-remote` package. MCP auth is noted as still flaky.

Can I run this locally?

Yes, clone the repository, set up the environment, and run `npm run dev`. Use `npm run playground` to start the MCP Inspector for debugging.

What transports or authentication does it use?

It uses a custom OAuth flow over HTTP/HTTPS (the MCP server endpoint is `/api/v1/mcp`). Authentication is handled via Neon Auth and OAuth tokens.

Comments

Basic information

More Developer Tools MCP servers

DevDocs by CyberAGI 🚀

cyberagiinc

Completely free, private, UI based Tech Documentation MCP server. Designed for coders and software developers in mind. Easily integrate into Cursor, Windsurf, Cline, Roo Code, Claude Desktop App

2.1K

Unity MCP (Server + Plugin)

IvanMurzak

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for fr

3.5K