mcpresso
mcpresso copied to clipboard
TypeScript framework to build robust, agent-ready MCP servers around your APIs.
MCPresso
The only MCP toolkit with production authentication
OAuth 2.1 • PostgreSQL auth database • MCP 2025-06-18 compliant
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.