Mcpresso

The only MCP toolkit with production authentication

OAuth 2.1 • PostgreSQL auth database • MCP 2025-06-18 compliant

npm CI Status TypeScript License

The Problem

Every MCP tutorial stops at localhost. Production needs authentication.

❌ No multi-user authentication in MCP tutorials
❌ OAuth 2.1 implementation complexity
❌ No production-ready auth examples

MCPresso CLI: OAuth 2.1 compliant MCP servers with dedicated auth database.

---

🚀 Choose Your Template

Single User Authentication

npx mcpresso init --template template-docker-single-user --name my-api --yes
cd my-api
npm install
npm run dev

→ OAuth 2.1 compliant authentication for single user scenarios

Multi-user with SQLite

npx mcpresso init --template template-express-oauth-sqlite --name my-api --yes
cd my-api
npm install
npm run db:init  # Initialize SQLite authentication database
npm run user:create "John Doe" "[email protected]" "password123"
npm run secret:generate
npm run dev

→ OAuth 2.1 authentication + SQLite auth database for few users

Multi-user with PostgreSQL

npx mcpresso init --template template-docker-oauth-postgresql --name my-api --yes
cd my-api
npm install
npm run db:init  # Initialize PostgreSQL authentication database
npm run user:create "John Doe" "[email protected]" "password123"
npm run secret:generate  # Generate JWT secret for OAuth 2.1
npm run dev

→ OAuth 2.1 authentication + PostgreSQL authentication database for more users

---

Beyond Authentication

👤 User context - Every handler gets authenticated user automatically
⚡ Auto CRUD - Zod schemas → REST endpoints
🔗 Relationships - Define connections between resources
⚙️ Custom Methods - Extend beyond CRUD with business logic
👥 Multi-tenancy - User data injection and scope-based access
🛡️ Production ready - Rate limiting, retries, server metadata

---

MCP Standards Compliance

MCPresso follows Model Context Protocol 2025-06-18 specifications:

🔐 OAuth 2.1 Authorization - MCP authorization standard with PKCE support
🌐 Streamable HTTP Transport - Transport specification with SSE
🛠️ Tools and Resources - Proper MCP tool definition and resource management
📋 Protocol Compliance - Full MCP lifecycle, message format, and error handling requirements

---

Examples

Hello World – Minimal server
Basic CRUD – Resource management
Custom Methods – Beyond CRUD
Multi-tenancy – User isolation

---

⭐ Star us if MCPresso solves your MCP authentication headaches.

---

MIT License. Experimental - pin version for production.