用途：在动手写代码前对项目创意或功能做“现实性检查”，判断是否已有大量同类项目、市场是增长还是衰退，从而决定继续、差异化或转向。
主要能力：核心 MCP 工具 idea_check，参数 idea_text（自然语言创意描述，必填）和 depth（quick 默认 / deep）。quick 只查 GitHub 与 Hacker News，通常 3 秒内返回；deep 覆盖全部 6 个来源，可能需 10–15 秒。返回 reality_signal（0–100）、duplicate_likelihood、trend（accelerating/stable/declining）、sub_scores（如 market_momentum）、evidence 证据计数、top_similars 竞品列表和 pivot_hints 转向提示。评分按来源加权，某一来源失败时权重自动重新分配。
使用方式：可用 uvx idea-reality-mcp 运行；Claude Code 用 claude mcp add idea-reality -- uvx idea-reality-mcp；Claude Desktop/Cursor 在 MCP 配置文件中加入 command 为 uvx、args 为 idea-reality-mcp 的 mcpServers 条目。首次运行 idea-reality setup 走交互向导，idea-reality doctor 做健康检查（--full 会验证全部来源）。也可不依赖 MCP，直接 POST https://idea-reality-mcp.onrender.com/api/check，JSON 含 idea_text 和 depth。可选环境变量 GITHUB_TOKEN 提高 GitHub 速率限制，PRODUCTHUNT_TOKEN 启用 Product Hunt（deep 模式）。
适用场景：项目启动前调研、功能重合度检查、市场趋势分析，以及在 .cursorrules、CLAUDE.md 或 .github/copilot-instructions.md 中配置自动触发；还提供 GitHub Action 用于验证标注 proposal 的议题。
限制：Product Hunt 数据需要令牌，否则 deep 模式会缺失该来源；GitHub 无令牌可能触发速率限制。创意描述需具体，过泛会导致结果不相关。评分、阈值和权重为工具自身规则，仅供参考，不替代人工调研。官方未在资料中说明收费与价格。