Neon Auth MCP OAuth

@andrelandgraf

Repository Homepage

Basic information

About Neon Auth MCP OAuth

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

#neon-auth#oauth #nextjs

Neon Auth MCP OAuth 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"
      ]
    }
  }
}

Neon Auth MCP OAuth tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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

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

More Developer Tools MCP servers

SSH MCP Server

hypnosis

SSH MCP server for AI agents: remote commands, file transfer, log search and server audits through OpenSSH.

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott

Cronwatch

cronwatchdev

CronWatch records every run of your scheduled jobs in your own database, and speaks up when one is missed, fails, gets stuck, runs slow or costs too much. CronWatch is free and open-source.

Kaiva Bridge

Kaiva Bridge turns your API, database or documents into a managed MCP server for Claude, ChatGPT, Cursor and VS Code. Point it at an OpenAPI or Swagger spec, an API docs link, a cURL command, a Postman collection, a Grap

GripForge

gripforgeai

The tools your AI needs to make your games. Turn prompts into production-ready game assets — animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs — and playable game kits Unity, Godot, U