PocketLantern
PocketLantern
你的 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,不同的事实。

Related MCP server: @4da/mcp-server
快速开始
先决条件:Node.js >= 22,一个 MCP 客户端(Claude Code、Cursor 等)
npm install -g pocketlanternClaude Code
在你的项目目录中:
cd your-project
pocketlantern initinit 会在 ~/.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 — 重启编辑器。
更多可尝试的查询
“Vercel 的定价随 Fluid Compute 有什么变化?” 账单拆分为活跃 CPU + 内存,共享进程并发会破坏隔离性
“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 & roadmapMonorepo: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 获取指南。
许可证
This server cannot be deployed
Maintenance
Related MCP Connectors
Vendor intelligence for AI coding agents choosing developer tools and stacks.
Open-source licence risk checks for AI coding agents and dependency trees.
Codebase intelligence for AI agents — dead code, blast radius, ownership.
Verified, sourced, real-time intelligence layer for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenancePersistent decision memory and contradiction detection for AI coding agents. Enforces architectural consistency across sessions — the agent cannot code until it loads prior decisions. Human resolves conflicts on a dashboard or in chat.1MIT
- AlicenseAqualityAmaintenanceDependency intelligence for AI agents. CVE scanning, health checks, upgrade planning.9741 npm2Apache 2.0
- AlicenseAqualityAmaintenanceEnforces team knowledge and workflow policies for AI coding agents by providing context, decisions, and gates before code changes are made.163Apache 2.0

coderadiusofficial
AlicenseNot gradedqualityCmaintenanceEnables AI agents to query architecture context, data contracts, and blast radius to prevent cross-repo architectural breakage before merging.24Apache 2.0