MCP注册管理服务

git clone https://github.com/your-org/mcp-registry.git
cd mcp-registry

pnpm install

# Start Supabase (requires Docker)
pnpm supabase:start

# Apply migrations and seed data
pnpm supabase:db:reset

# Generate TypeScript types
pnpm supabase:types

NEXT_PUBLIC_SUPABASE_URL=http://127.0.0.1:54321
NEXT_PUBLIC_SUPABASE_ANON_KEY=<anon-key-from-supabase-start-output>

-- Replace with your actual user ID from auth.users table
UPDATE public.profiles
SET role = 'admin'
WHERE id = '<your-user-id>';

pnpm dev

mcp-registry/
├── app/                    # Next.js App Router pages
│   ├── api/health/        # Health check endpoint
│   ├── auth/callback/     # Magic link auth callback
│   ├── signin/            # Sign in page
│   ├── submit/            # Submit new server form
│   ├── my/submissions/    # User's submission list
│   ├── admin/submissions/ # Admin moderation page
│   ├── servers/           # Browse MCP servers
│   │   ├── page.tsx       # Server list with filters
│   │   └── [slug]/        # Server detail page
│   ├── layout.tsx         # Root layout
│   ├── page.tsx           # Homepage
│   └── globals.css        # Global styles
├── components/            # React components
│   ├── header.tsx         # Site header with auth state
│   ├── footer.tsx         # Site footer
│   └── auth-buttons.tsx   # Auth-aware navigation
├── lib/                   # Utility libraries
│   └── supabase/          # Supabase client utilities
│       ├── client.ts      # Browser client
│       ├── server.ts      # Server client
│       ├── database.types.ts  # Generated types
│       └── types.ts       # Type helpers
├── supabase/              # Supabase CLI
│   ├── config.toml        # Local config
│   ├── migrations/        # SQL migrations
│   └── seed.sql           # Dev seed data
├── __tests__/             # Unit tests (Vitest)
├── e2e/                   # E2E tests (Playwright)
├── middleware.ts          # Auth session refresh
└── .github/workflows/     # GitHub Actions CI

# Start local Supabase (requires Docker)
pnpm supabase:start

# Apply migrations and seed data
pnpm supabase:db:reset

# Generate TypeScript types from local schema
pnpm supabase:types

# Stop local Supabase
pnpm supabase:stop

# Link to remote project (one-time setup)
supabase link --project-ref <your-project-ref>

# Push migrations to remote
pnpm supabase:db:push

# Generate types from remote
supabase gen types typescript --linked > lib/supabase/database.types.ts

# Create a new migration
supabase migration new <migration_name>

# Edit the migration file in supabase/migrations/

# Apply locally
pnpm supabase:db:reset

# Push to remote when ready
pnpm supabase:db:push

# Wrong: Editing 20260101_create_function.sql after it was applied

# Correct: Create a new migration
supabase migration new fix_function_xyz
# Then add ALTER/CREATE OR REPLACE statements in the new file

supabase link --project-ref <your-project-ref>
supabase db push

# 1. Set environment variables in Vercel:
#    - SUPABASE_SERVICE_ROLE_KEY (from Supabase Dashboard → Settings → API)
#    - ADMIN_BOOTSTRAP_TOKEN (generate a random string)
#    - ADMIN_BOOTSTRAP_EMAIL (your email address)

# 2. Sign up first by visiting /signin and clicking the magic link

# 3. Call the bootstrap endpoint
curl -X POST https://your-app.vercel.app/api/admin/bootstrap \
  -H "Content-Type: application/json" \
  -H "x-bootstrap-token: YOUR_ADMIN_BOOTSTRAP_TOKEN" \
  -d '{"email": "your-email@example.com"}'

# Expected response: {"success":true,"message":"Admin bootstrap completed","userId":"..."}

-- In Supabase SQL Editor
-- First, find your user ID after signing in
SELECT id, email FROM auth.users;

-- Then update their profile
UPDATE public.profiles
SET role = 'admin'
WHERE id = '<your-user-id>';

# Run all tests
pnpm test

# Watch mode
pnpm test:watch

# With coverage
pnpm test:coverage

# Run E2E tests
pnpm test:e2e

# Interactive UI mode
pnpm test:e2e:ui

# Install browsers (first time)
pnpm exec playwright install

# Run product spec tests only
pnpm exec playwright test product-spec

# Run with verbose output
pnpm exec playwright test product-spec --reporter=list

# Run inventory + gap report generation
pnpm test:e2e:inventory

# View the generated reports
cat e2e/reports/product-inventory.json | jq '.summary'
cat e2e/reports/product-gaps.json | jq '.notes'

{
  "generatedAt": "2026-02-14T...",
  "pageCount": 12,
  "totalInternalLinks": 45,
  "pages": [
    {
      "url": "/servers",
      "name": "Browse Servers",
      "status": 200,
      "h1Text": "MCP Server Registry",
      "internalLinkCount": 15,
      "hasBreadcrumbs": false,
      "hasCodeBlock": false,
      "a11y": { "hasMainLandmark": true, "hasH1": true, ... }
    }
  ],
  "summary": {
    "pagesWithErrors": 0,
    "pagesWithoutH1": 0,
    "pagesWithCodeBlocks": 3
  }
}

# Run heuristics + merge into gap report
pnpm test:e2e:heuristics

# View heuristics summary
cat e2e/reports/product-heuristics.json | jq '.summary'

# Generate backlog from gap report
pnpm product:backlog

# 1. Run heuristics first (source of heuristic gaps)
pnpm test:e2e:heuristics

# 2. Run inventory (derives report + preserves merged heuristicGaps)
pnpm test:e2e:inventory

# 3. Validate deterministic merged report shape
pnpm exec playwright test e2e/product-gaps.spec.ts

# 4. Generate markdown backlog from canonical report
pnpm product:backlog

# 5. Review the backlog
cat docs/product-backlog.md

# Run perf trend capture only
pnpm test:e2e:perf-trends

# Compare current trends vs last committed baseline
pnpm perf:compare

# Generate all perf outputs (smoke + trends + regressions)
pnpm perf:report

pnpm audit:sha <sha>

# Full local validation workflow
pnpm supabase:start
pnpm supabase:db:reset
pnpm supabase:types
pnpm dev &
pnpm test
pnpm test:e2e