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.
Basic information
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.
More Developer Tools MCP servers
MCP-Scan: An MCP Security Scanner
invariantlabs-aiSecurity scanner for AI agents, MCP servers and agent skills.
Smithery CLI
smithery-aiInstall, manage and develop MCP servers and skills for agents
nuxt-mcp / vite-plugin-mcp
antfuMCP server helping models to understand your Vite/Nuxt app better.
test
prysmaticlabsGo implementation of Ethereum proof of stake
test
cloudwegoThe ultimate LLM/AI application development framework in Go.
Comments