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

3つの質問。3つのブロッカータイプ。同じ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に1行のルールを追加します。Claude Codeを再起動(Ctrl+Cの後、再度claudeを実行)してから、最初のクエリを投げてください。

Cursor / Windsurf / その他のMCPクライアント

MCP設定に追加します(Cursorの場合: ~/.cursor/mcp.json):

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

次に、プロジェクトのルールファイル(.cursorrules、Kiroステアリングファイルなど)に以下の行を追加します:

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 more

デプロイメント, 開発ツール, テスト, セキュリティ, コンプライアンス, ...

カードの構成

各カードは、ソースリンク付きの事実と公式リファレンスリンクを含む構造化された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