MCP Server with Clerk Authentication

A Next.js-based Model Context Protocol (MCP) server with integrated Clerk authentication and user-specific API key management.

Quick Start

1. Clone and install:

   git clone [repository-url]
   cd ve-nextjs-mcp-server
   npm install

2. Configure Clerk (see PROJECT_DOCUMENTATION.md for detailed instructions):

   • Create Clerk account and application

   • Disable sign-ups in Clerk dashboard

   • Copy environment variables to .env.local

3. Start development server:

   npm run dev

4. Access dashboard:

   • Visit http://localhost:3000

   • Sign in with authorized account

   • Create API keys for MCP access

Related MCP server: ServeMyAPI

Documentation

• PROJECT_DOCUMENTATION.md - Complete project documentation for AI agents and developers

• examples/ - Authentication examples and client code

Features

• 🔐 Clerk Authentication - Sign-in only access control

• 🗝️ API Key Management - User-specific key creation and management

• ⚙️ MCP Integration - Ready-to-use MCP server with Next.js documentation tool

• 🛡️ Multiple Auth Methods - User keys, OAuth 2.1 with PKCE (Proof Key for Code Exchange), bearer tokens

• 📱 Responsive Dashboard - Modern UI for key management

API Usage

# Create API key in dashboard first, then:
curl -X POST http://localhost:3000/api/mcp \
  -H "Authorization: Bearer mcp_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "get_nextjs_docs",
      "arguments": {"topic": "app router"}
    },
    "id": 1
  }'

Security

• ✅ Sign-in only access (no public registration)

• ✅ Admin-controlled user management

• ✅ User-isolated API keys

• ✅ Scoped permissions

• ✅ Secure key generation

For complete documentation, see PROJECT_DOCUMENTATION.md.