buildmymcpserver/README.md

BuildMyMCPServer

Describe your tool. We host the server. AI uses it.

Prompt-to-production MCP servers with OAuth 2.1 and Streamable HTTP.

Run locally

# 1. Install deps
pnpm install

# 2. Copy env and fill ANTHROPIC_API_KEY if you want real generation
cp .env.example .env

# 3. Boot everything (postgres, redis, web, api, generator)
pnpm dev

Then open:

• Dashboard: http://localhost:3000
• API: http://localhost:4000

Sign in with the magic link printed to the API stdout, click New Server, paste a prompt, watch the build stream live over WebSocket.

Architecture

See BuildMyMCPServer_MASTER_PROMPT.md for the full spec and CHOICES.md for the decisions made during Sprints 1–3.

Workspace layout

apps/
  web/              Next.js 15 dashboard + marketing
  api/              Fastify control plane
  generator/        BullMQ worker — Claude → build → deploy
  runner-template/  Hosted MCP server template
packages/
  db/               Drizzle schema + client
  auth/             Better-Auth wrapper
  types/            Shared Zod types
  ui/               Shared React primitives