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 引导文件等):

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. “Vercel 的定价随 Fluid Compute 有什么变化?” 账单拆分为活跃 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 迁移、模型定价、批处理与流式传输

serverless

Vercel、Cloudflare Workers、Lambda 成本与运行时

infra

托管平台、Terraform、Node.js LTS、Python EOL

backend

Supabase 与 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

Monorepo: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