idea-reality-mcp MCP — 使用场景, 安装 & 实时演示

为什么要用

核心特性

一个工具：idea_check，支持快速模式（<3秒）或深度模式
扫描 6 个来源：GitHub、HN、npm、PyPI、Product Hunt、Stack Overflow
返回 0-100 的现实指数 + 趋势方向 + 转向建议
基础使用无需认证；可选 token 获得更高限额

实时演示

实际使用效果

idea-reality.replay ▶ 就绪

0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "idea-reality": {
      "command": "uvx",
      "args": [
        "idea-reality-mcp"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "idea-reality": {
      "command": "uvx",
      "args": [
        "idea-reality-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "idea-reality": {
      "command": "uvx",
      "args": [
        "idea-reality-mcp"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "idea-reality": {
      "command": "uvx",
      "args": [
        "idea-reality-mcp"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "idea-reality",
      "command": "uvx",
      "args": [
        "idea-reality-mcp"
      ]
    }
  ]
}

Continue 使用服务器对象数组，而非映射。

~/.config/zed/settings.json

{
  "context_servers": {
    "idea-reality": {
      "command": {
        "path": "uvx",
        "args": [
          "idea-reality-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add idea-reality -- uvx idea-reality-mcp

一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。

使用场景

实战用法： idea-reality-mcp

建造前 10 秒内验证 SaaS 想法

👤 创业者、独立开发者、副业开发者 ⏱ ~10 min beginner

何时使用： 凌晨 2 点突然有个「我应该做 X」的想法——先跑一遍现实检查。

步骤

快速检查

在 idea_check 上运行「一个用机器学习预测浇水时间的手机应用」。选择快速深度。✓ 已复制

→ 0-100 的评分 + 前 5 个现有项目
如果看起来有前景就深入挖掘

如果快速评分 <60，运行深度模式扫描完整市场，包括 Product Hunt 上的发布。✓ 已复制

→ 更完整的列表，带趋势箭头 + 融资信号
如果太拥挤就转向

根据前 5 个竞品，建议 3 个竞争较少的转向角度。✓ 已复制

→ 具体的、更细分的定位选项

结果： 10 分钟基于证据的分类决策，而不是 10 个周末的平行开发。

注意事项

评分高仅仅是因为没人做过——可能只是没人要 — 看 HN 评论 + Stack Overflow 问题数；零需求信号和过度饱和一样糟

产品启动前绘制现有竞品地图

👤 产品经理、撰写一页纸的创业者 ⏱ ~20 min intermediate

何时使用： 你在界定产品范围，需要一个真实的竞品列表，而不是自己有偏见的认知。

前置条件

GITHUB_TOKEN 获得更高速率限制 — github.com/settings/tokens——不需要任何权限范围

步骤

运行深度模式

对「远程团队实时协作代码审查工具」运行深度 idea_check。✓ 已复制

→ 10+ 个竞品列表，包含 stars/发布时间/日期
按方法分组

按方法对竞品分组（IDE 插件 vs 独立应用 vs 浏览器扩展）。缺少什么？✓ 已复制

→ 差距分析

结果： 一张有真实竞品地图的一页纸。

搭配使用： firecrawl

组合

与其他 MCP 搭配，撬动十倍杠杆

idea-reality + firecrawl

深入研究竞品的落地页/定价页以了解真实定位

idea_check 标记了竞品 X。用 firecrawl 抓取他们的定价页并总结他们的方案。✓ 已复制

idea-reality + notion

把验证结果倒进验证日志

对今天「AI 园艺工具」的 idea_check，在 Notion 创建一个页面记录评分和竞品列表。✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用	成本
idea_check	idea_text: str, depth?: 'quick'\|'deep'	任何值得花超过 30 分钟的想法建造前先检查	Free public APIs; optional GitHub token raises limits

成本与限制

运行它的成本

API 配额: GitHub 无认证：60/小时；有 token：5k/小时。其他：公开速率限制
每次调用 Token 数: 快速：500-1500；深度：2-5k
费用: 免费
提示: 总是从快速模式开始；深度模式代价高，对于饱和领域很少改变结论

安全

权限、密钥、影响范围

凭据存储： 可选 GITHUB_TOKEN、PRODUCTHUNT_TOKEN 在环境变量中

数据出站： api.github.com, news.ycombinator.com, registry.npmjs.org, pypi.org, api.producthunt.com, api.stackexchange.com

切勿授予： repo write scopes

故障排查

常见错误与修复

速率限制（GitHub 403）

设置 GITHUB_TOKEN 环境变量，包含一个 token（不需要任何权限范围）

验证： curl -H 'Authorization: Bearer <token>' https://api.github.com/rate_limit

深度模式返回空的 Product Hunt 结果

需要 PRODUCTHUNT_TOKEN——可以在 producthunt.com/v2/oauth 免费获取

评分似乎离谱

更具体地描述想法；'AI 应用'匹配所有东西，评分为 0

替代方案

idea-reality-mcp 对比其他方案

替代方案	何时用它替代	权衡
手动 Google + GitHub 搜索	你有 2 小时可以花	更慢，不够系统
Exploding Topics	你想要趋势数据，而不是竞品列表	付费，没有 MCP

idea-reality-mcp