Mcpresso

Use the `mcpresso init` command to generate a project from one of three templates: single-user Docker, multi-user with SQLite, or multi-user with PostgreSQL. Choose based on your deployment needs.

# Single-user (simplest start)
npx mcpresso init --template template-docker-single-user --name my-api --yes

# Multi-user with SQLite
npx mcpresso init --template template-express-oauth-sqlite --name my-api --yes

# Multi-user with PostgreSQL
npx mcpresso init --template template-docker-oauth-postgresql --name my-api --yes

Navigate into the generated project, install npm dependencies, and run the database initialization script to create the required schema tables.

cd my-api
npm install
npm run db:init

For multi-user templates, create at least one user account and generate the JWT signing secret used for OAuth 2.1 token issuance.

npm run user:create "Jane Doe" "[email protected]" "securepassword123"
npm run secret:generate

Open the generated server source file and define your tools using Zod schemas. MCPresso automatically generates CRUD endpoints and validates inputs against the schemas.

// src/tools.ts (generated file — customize here)
import { z } from 'zod';

export const CreateItemSchema = z.object({
  name: z.string(),
  value: z.number(),
});

// Register as a tool in your server config

Run the dev server. MCPresso starts an HTTP server implementing the MCP Streamable HTTP transport (2025-06-18 spec) that your MCP client can connect to.

npm run dev

Point your MCP client at the running MCPresso server. For Claude Desktop, add the server entry to your config file specifying the HTTP endpoint.

{
  "mcpServers": {
    "my-api": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/my-api"
    }
  }
}