mcpresso

MCPresso provides production-ready OAuth 2.1 authentication for MCP servers, backed by a dedicated auth database (PostgreSQL) and MCP 2025-06-18 compliance. It offers templates for single-user authentication, multi-user setups with SQLite, and multi-user setups with PostgreSQL. The framework exposes automated CRUD generation, user context propagation to handlers, and support for multi-tenancy, along with production-oriented features like rate limiting, retry strategies, and server metadata.

To get started, use the MCPresso CLI to bootstrap a server template, then install dependencies and run the development server. For example, you can start with the single-user template or the PostgreSQL template for more users. After initialization, use the provided npm scripts (db:init, user:create, secret:generate) as appropriate, then launch the dev server with npm run dev. The tooling will ensure OAuth 2.1 flows (PKCE) are wired to your auth database and that resource handlers receive authenticated user context automatically.

Prerequisites:

• Node.js v16+ (with npm or pnpm)
• Optional: Docker for local PostgreSQL or template-based docker setup
• Access to a PostgreSQL database for production-like auth (or SQLite for simple local testing)

Steps:

1. Install Node.js and npm from https://nodejs.org
2. Install and bootstrap MCPresso templates globally via npx
3. Initialize a new MCPresso project using a template (single-user or multi-user)
4. Install dependencies and configure the environment (DB connection strings, secrets, etc.)
5. Run the development server and apply migrations or database initialization scripts as needed

Example commands:

• Initialize a template (single-user): npx mcpresso init --template template-docker-single-user --name my-api --yes cd my-api npm install npm run dev

• Initialize a template (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" "john@example.com" "password123" npm run secret:generate # Generate JWT secret for OAuth 2.1 npm run dev

If you prefer Docker-based PostgreSQL, you can use docker-compose or the provided docker templates to launch a local DB instance and connect via environment variables in your .env file.

Notes and tips:

• The MCPresso templates come with environment presets for DB connection strings; ensure DB_HOST, DB_PORT, DB_USER, DB_PASSWORD, and DB_NAME are correctly configured.
• For production-like setups, use PostgreSQL and initialize the database with db:init, then create a user via user:create and generate a JWT secret with secret:generate.
• If you encounter onboarding issues, verify OAuth 2.1 PKCE support is enabled in your client configuration and that redirect URIs match your server endpoints.
• The framework supports auto CRUD generation from Zod schemas and provides examples for multi-tenancy and custom methods to extend business logic.
• Review the MCP standards compliance section in the README to ensure your deployments adhere to the 2025-06-18 MCP specifications.