Skip to main content
Glama

PocketLantern

npm version npm downloads CI License: MIT

AI 에이전트가 자신 있게 말하지만, 차단 요소를 놓치고 있습니다.

가격은 변하고, 버전은 깨지며, 라이선스는 바뀝니다. PocketLantern은 출처가 명시된 시간 민감형 사실을 기반으로 AI 코딩 에이전트에게 차단 요소를 알려주는 의사결정 레이어입니다.

다음 질문들을 시도해 보세요

PocketLantern을 설치한 후 AI 에이전트에게 물어보세요:

"어떤 인증 제공자를 선택할까요? Clerk, Auth0, 아니면 Cognito?"

⚠️ Cognito password hashes are permanently non-exportable
⚠️ Auth0 password export requires support ticket — Free tier excluded
⚠️ Auth0 Rules/Hooks EOL 2026-11-18 — Actions not portable
✅ Clerk has the most flexible migration path

"Next.js 16으로 업그레이드해야 할까요?"

⚠️ Sync API access fully removed — all dynamic calls must be awaited
⚠️ Custom webpack config breaks next build
⚠️ next lint removed — switch to Biome or ESLint CLI
⚠️ Requires Node.js 20.9.0+, TypeScript 5.1.0+, React 19.0+
✅ Plan phased migration — codemod doesn't cover webpack or middleware

"OpenAI Realtime API를 사용할 수 있을까요?"

⚠️ gpt-4o-realtime-preview removed 2026-05-07
⚠️ Beta interface (realtime=v1 header) removed same date
⚠️ GA event schema incompatible — 4 event renames
✅ Start on GA from day one — or plan dual-stack migration

세 가지 질문. 세 가지 차단 요소 유형. 같은 AI, 하지만 다른 사실 기반.

PocketLantern 데모 — Node.js 20→24 업그레이드 차단 요소가 즉시 표시됨

Related MCP server: @4da/mcp-server

빠른 시작

전제 조건: Node.js >= 22, MCP 클라이언트 (Claude Code, Cursor 등)

npm install -g pocketlantern

Claude Code

프로젝트 디렉토리에서:

cd your-project
pocketlantern init

init은 ~/.claude.json에 MCP 서버를 등록하고 프로젝트의 CLAUDE.md에 한 줄 규칙을 추가합니다. Claude Code를 재시작(Ctrl+C 후 다시 claude 실행)한 다음 첫 번째 질문을 해보세요.

Cursor / Windsurf / 기타 MCP 클라이언트

MCP 설정에 추가하세요 (Cursor: ~/.cursor/mcp.json):

{
  "mcpServers": {
    "pocketlantern": {
      "command": "pocketlantern-mcp"
    }
  }
}

그런 다음 프로젝트 규칙(.cursorrules, Kiro steering 파일 등)에 이 줄을 추가하세요:

For technology decisions, upgrades, migrations, or licensing questions: before finalizing your answer, check the PocketLantern MCP server's search_cards tool for blockers in these bundled decision cards — your training data may be stale.

MCP 서버를 다시 로드하세요: Cursor — Cmd+Shift+P -> "MCP: Restart Servers". Windsurf — 에디터 재시작.

더 많은 질문 시도하기

  1. "Fluid Compute 도입으로 Vercel 가격 정책이 어떻게 바뀌었나요?" 과금 방식이 활성 CPU + 메모리로 분할되었으며, 공유 프로세스 동시성으로 인해 격리 문제가 발생함

  2. "Edge/서버리스 환경에는 Prisma와 Drizzle 중 무엇이 좋을까요?" Prisma v7 ESM + 드라이버 어댑터 호환성 문제, Edge는 프리뷰 전용; Drizzle 0.30-1.0 역시 호환성 문제 발생

설치 확인

pocketlantern doctor               # check installation status
pocketlantern search "auth pricing" # search cards from CLI

작동 원리

PocketLantern은 MCP 서버입니다. AI 에이전트가 search_cards를 호출하면 출처가 명시된 의사결정 카드와 함께 사용 가능한 경우 출처가 명시된 차단 요소 경고를 받습니다.

Agent asks question
  -> search_cards("clerk vs auth0 authentication")
  -> 3 cards + 5 blocker warnings (lock-in, EOL, export restrictions)
  -> Agent answers with source-linked constraints

로컬 카드셋. 즉각적인 조회. 벡터 데이터베이스 없음. 임베딩 없음. 키워드 검색, 카드 링크, 그리고 가능한 경우 출처가 명시된 차단 요소 경고를 제공합니다. 핵심 가치는 단순한 검색이 아니라 출처가 명시된 의사결정 카드에 있습니다.

search_cards("auth", constraints:["serverless"]) -> cards + blockers
get_card("auth/clerk-vs-auth0-vs-cognito-2026")  -> full card with facts
get_related_cards(...)                           -> connected topics

포함된 내용

27개 카테고리에 걸친 차단 요소 인식 의사결정 카드와 번들된 그래프 인덱스에서 제공하는 출처 명시형 차단 요소 경고가 포함되어 있습니다. npm 패키지로 제공되며 즉시 작동하고, 네트워크나 계정이 필요 없습니다:

카테고리

포함 범위

auth

벤더 종속, 마이그레이션 고충, SSO, RBAC, 패스키

frontend

Next.js, React, Svelte, Vite, Angular 업그레이드 차단 요소

database

Prisma, Drizzle, Postgres, Aurora, Neon, Supabase

ai

OpenAI API 마이그레이션, 모델 가격, 배치 vs 스트리밍

serverless

Vercel, Cloudflare Workers, Lambda 비용 및 런타임

infra

호스팅 플랫폼, Terraform, Node.js LTS, Python EOL

backend

Supabase vs Firebase, Express, 작업 큐, 실시간 동기화

+ 18개 추가

배포, 개발 도구, 테스트, 보안, 규정 준수 등

카드 예시

각 카드는 출처가 명시된 사실과 공식 참조 링크가 포함된 구조화된 YAML 파일입니다:

id: auth/clerk-vs-auth0-vs-cognito-2026
title: Clerk vs Auth0 vs Cognito Under Current Pricing and Feature Changes
problem: Select an auth vendor given recent pricing shifts, MAU economics, ...
constraints: [cost-sensitive, low-ops, enterprise, compliance, serverless]
candidates:
  - name: Clerk
    summary: "Pro starts at $20/mo, includes 50,000 MRUs per app..."
    when_to_use: "Choose for small-team + low-ops + cost-sensitive SaaS..."
    tradeoffs: "Best DX and fastest implementation..."
    cautions: "Be precise about org-member limits..."
    links:
      - https://clerk.com/pricing
      - https://clerk.com/docs/guides/organizations/configure
  - name: Auth0
    # ...
  - name: Amazon Cognito
    # ...
tags: [auth, clerk, auth0, pricing, passkeys, b2b, compliance]
related_cards: [auth/sso-for-b2b-saas, auth/rbac-vs-abac-vs-rebac]
updated: 2026-03-14

전체 스키마 정의는 packages/schema/src/card.ts를 참조하세요.

프로젝트 구조

pocketlantern/
  packages/schema/       <- Card schema (zod + TypeScript types)
  apps/mcp-server/       <- MCP server (search, retrieval, tool handlers)
  apps/cli/              <- CLI (validate, search, init, doctor)
  packages/knowledge/    <- Decision cards + graph index (data package)
  docs/                  <- User guides & roadmap

모노레포: pnpm 워크스페이스. 빌드 순서: schema -> knowledge (빌드 없음) -> mcp-server -> cli.

개발

pnpm build              # Build all packages
pnpm test               # Run tests (299 tests)
pnpm test:coverage      # Run with coverage report
pnpm lint               # ESLint
pnpm format:check       # Prettier check

누락된 주제가 있나요? Card Requests에서 다룰 내용을 요청하세요.

기여

도구(스키마, MCP 서버, CLI, 검색)에 대한 기여를 환영합니다. 가이드라인은 CONTRIBUTING.md를 참조하세요.

라이선스

MIT

Related MCP Connectors

Related MCP Servers