This is a Next.js-based application that provides an MCP (Model Context Protocol) server with OAuth 2.1 authentication support. It is intended as a model for building your own MCP server in a Next.js context.

In addition to being an OAuth server, it also requires the user authenticate. This is currently configured to use Google OAuth, but you could authenticate users however you want.

Using with

MCP Inspector

Tell Inspector to connect to http://localhost:3000/sse, with Streamable HTTP transport.

Cursor

Add this to your mcp.json:

"my_server": {
  "name": "My Server",
  "url": "http://localhost:3000/sse",
  "transport": "sse"
}

VSCode

VSCode doesn't properly evict the client ID, so client registration fails if you accidentally delete the client. Otherwise, it works fine. Add this to your settings.json:

"mcp": {
    "servers": {
        "My Server": {
            "url": "http://localhost:3000/sse"
        }
    }
}

Claude Desktop and Claude.ai

Use the "Connect Apps" button and select "Add Integration". Provide the URL of your server. This may give you trouble if it's localhost but works as a remote server.

Running the server

npm install
npm run dev

Required environment variables in .env: (not .env.local because Prisma doesn't support it)

DATABASE_URL="postgresql://user:pass@server/database" AUTH_SECRET=any random string GOOGLE_CLIENT_ID=a Google OAuth client ID GOOGLE_CLIENT_SECRET=a Google OAuth client secret