What it does
Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt — returns 0-100 signal.
- Connects 在你的电脑上运行
- Account or key No key needed
- Category 开发者工具
可搭配使用
教 AI 做这类工作的 Skill,可与本项一起使用
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
graphify
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
为什么排在这里
列表按使用分(满分 100)排序,由以下部分组成
| 热度 | 35/80 | GitHub 星标或每周下载量:较大的计 60,较小的计 20 |
|---|---|---|
| 新鲜度 | 7/12 | 30 天内有发布或代码更新得满分 |
| 仍在响应 | 0/8 | 上次检查时云端端点有响应 |
| 使用分 | 42/100 |
质量: 基础检查通过 3/3 项(仅展示,不用于排序) · 上升势头: 暂无数据 (只用于“上升中”标签)
安装
选择你使用的 AI 应用,然后复制设置。
用一句话让 AI 帮你安装
请帮我安装 Idea Reality MCP。按照 https://mcp.popnx.com/i/mnemox-ai-idea-reality-mcp.md 操作,先把命令给我看,等我同意后再运行。粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文
通过 3/3 项检查 · 在你的电脑上运行 · ✓ 命令已检查 2026年11月14日
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
可连接 Claude,但需要先准备
需要先在电脑上安装 Python (uv)(只需一次) · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用
让 AI 帮你安装
把这段话复制到 Claude 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。
请在这台电脑上为 Claude 安装 MCP server Idea Reality MCP,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "mcpServers": { "idea-reality": { "command": "uvx", "args": [ "idea-reality-mcp" ] } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) 不需要密钥。5) 按约定执行,然后确认 Idea Reality MCP 的工具真的出现了。这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。
安装 uv(如果还没有)
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
uv --version- 显示版本号(例如 uv …)= 已安装,可跳过这一步
- 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
怎么打开终端
Mac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载
装好后关掉终端再打开,重新运行同一条命令,应显示版本号:
uv --version安装一次,所有需要 uv 的工具都能用
打开电脑版 Claude 应用的设置文件
SettingsDeveloperEdit Config
粘贴这些设置并保存文件
{ "mcpServers": { "idea-reality": { "command": "uvx", "args": [ "idea-reality-mcp" ] } } }退出 Claude 再重新打开
试一试
用 Idea Reality MCP 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude 说正在使用 Idea Reality MCP,或回答中出现 Idea Reality MCP 的工具名称,就表示连接成功
2 项可选设置(不填也能用)
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
ChatGPT 暂时无法连接 Idea Reality MCP
Idea Reality MCP 需要安装在你的电脑上,而 ChatGPT 只能连接在网上运行的服务器
你可以改用这些方式
A · 使用能连接 Idea Reality MCP 的应用
- 需要先在电脑上安装 Python (uv)(只需一次) · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用
- 需要先在电脑上安装 Python (uv)(只需一次)
- 需要先在电脑上安装 Python (uv)(只需一次)
- 需要先在电脑上安装 Python (uv)(只需一次)
B · 开发者工具 类中能连接 ChatGPT 的其他服务器
从同类中使用较多的里挑选,仅限用地址即可连接、无需密钥的
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
可连接 Claude Code,但需要先准备
需要先在电脑上安装 Python (uv)(只需一次)
让 AI 帮你安装
把这段话复制到 Claude Code 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。
请在这台电脑上为 Claude Code 安装 MCP server Idea Reality MCP,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):claude mcp add --scope user idea-reality -- uvx idea-reality-mcp 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) 不需要密钥。5) 按约定执行,然后确认 Idea Reality MCP 的工具真的出现了。这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。
安装 uv(如果还没有)
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
uv --version- 显示版本号(例如 uv …)= 已安装,可跳过这一步
- 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
怎么打开终端
Mac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载
装好后关掉终端再打开,重新运行同一条命令,应显示版本号:
uv --version安装一次,所有需要 uv 的工具都能用
打开终端
Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell
粘贴这条命令并按 Enter
claude mcp add --scope user idea-reality -- uvx idea-reality-mcp在 Claude Code 中输入 /mcp
应能看到 Idea Reality MCP 在列表中并显示已连接
试一试
用 Idea Reality MCP 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude Code 说正在使用 Idea Reality MCP,或回答中出现 Idea Reality MCP 的工具名称,就表示连接成功
2 项可选设置(不填也能用)
上面的命令不填这些也能用。想调整时再按开发者的说明添加。
GITHUB_TOKEN用于提高速率限制的 GitHub PAT(可选)。查看英文原文
GitHub PAT for higher rate limits (optional)PRODUCTHUNT_TOKEN用于深度模式的 Product Hunt API 令牌(可选)。查看英文原文
Product Hunt API token for deep mode (optional)
说明为自动翻译,变量名保持原样;不确定时请查看原文。
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Cursor,但需要先准备
需要先在电脑上安装 Python (uv)(只需一次)
让 AI 帮你安装
把这段话复制到 Cursor 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。
请在这台电脑上为 Cursor 安装 MCP server Idea Reality MCP,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "mcpServers": { "idea-reality": { "command": "uvx", "args": [ "idea-reality-mcp" ] } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) 不需要密钥。5) 按约定执行,然后确认 Idea Reality MCP 的工具真的出现了。这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。
安装 uv(如果还没有)
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
uv --version- 显示版本号(例如 uv …)= 已安装,可跳过这一步
- 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
怎么打开终端
Mac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载
装好后关掉终端再打开,重新运行同一条命令,应显示版本号:
uv --version安装一次,所有需要 uv 的工具都能用
在 Cursor 中以 Agent 模式打开 AI 聊天
试一试
用 Idea Reality MCP 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Cursor 说正在使用 Idea Reality MCP,或回答中出现 Idea Reality MCP 的工具名称,就表示连接成功
2 项可选设置(不填也能用)
上面的命令不填这些也能用。想调整时再按开发者的说明添加。
GITHUB_TOKEN用于提高速率限制的 GitHub PAT(可选)。查看英文原文
GitHub PAT for higher rate limits (optional)PRODUCTHUNT_TOKEN用于深度模式的 Product Hunt API 令牌(可选)。查看英文原文
Product Hunt API token for deep mode (optional)
说明为自动翻译,变量名保持原样;不确定时请查看原文。
菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同
可连接 VS Code,但需要先准备
需要先在电脑上安装 Python (uv)(只需一次)
让 AI 帮你安装
把这段话复制到 VS Code 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。
请在这台电脑上为 VS Code 安装 MCP server Idea Reality MCP,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "servers": { "idea-reality": { "type": "stdio", "command": "uvx", "args": [ "idea-reality-mcp" ] } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) 不需要密钥。5) 按约定执行,然后确认 Idea Reality MCP 的工具真的出现了。这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。
安装 uv(如果还没有)
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
uv --version- 显示版本号(例如 uv …)= 已安装,可跳过这一步
- 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
怎么打开终端
Mac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载
装好后关掉终端再打开,重新运行同一条命令,应显示版本号:
uv --version安装一次,所有需要 uv 的工具都能用
在 VS Code 中以 Agent 模式打开 AI 聊天
试一试
用 Idea Reality MCP 告诉我你能帮我做什么,然后做一件给我看✓ 如果 VS Code 说正在使用 Idea Reality MCP,或回答中出现 Idea Reality MCP 的工具名称,就表示连接成功
2 项可选设置(不填也能用)
上面的命令不填这些也能用。想调整时再按开发者的说明添加。
GITHUB_TOKEN用于提高速率限制的 GitHub PAT(可选)。查看英文原文
GitHub PAT for higher rate limits (optional)PRODUCTHUNT_TOKEN用于深度模式的 Product Hunt API 令牌(可选)。查看英文原文
Product Hunt API token for deep mode (optional)
说明为自动翻译,变量名保持原样;不确定时请查看原文。
菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同
开发者专用:终端命令和 JSON 设置
安装在电脑上
Claude Code
claude mcp add --scope user idea-reality -- uvx idea-reality-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"idea-reality": {
"command": "uvx",
"args": [
"idea-reality-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"idea-reality": {
"command": "uvx",
"args": [
"idea-reality-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"idea-reality": {
"type": "stdio",
"command": "uvx",
"args": [
"idea-reality-mcp"
]
}
}
}需要你填写的值
GITHUB_TOKEN机密 env用于提高速率限制的 GitHub PAT(可选)。查看英文原文
GitHub PAT for higher rate limits (optional)PRODUCTHUNT_TOKEN机密 env用于深度模式的 Product Hunt API 令牌(可选)。查看英文原文
Product Hunt API token for deep mode (optional)
说明为自动翻译,变量名保持原样;不确定时请查看原文。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
一览
哪些应用可以使用它
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
在你的电脑上运行,适用于
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
它能做什么
它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月19日
- ✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 mnemox-ai 验证,该账户拥有此仓库
- ✓ 通过
仍在维护
代码最后更新于2个月前
- ✓ 通过
有许可证
使用 MIT
- – 不适用
端点有响应
它在你的电脑上运行,没有互联网端点
- – 不适用
使用 OAuth 登录
在你的电脑上运行,改用本地设置
- … 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行;我们只能读取互联网端点的工具列表
已公开的漏洞(OSV.dev)
OSV.dev 中没有 idea-reality-mcp@0.3.4 的记录
只检查这个版本的包本身,不包括所有依赖 · 检查于 2026年11月15日
作者:申请重新检查或报告信息错误
给作者:在 README 中加徽章
如果你是作者,可把这段代码贴到 README。徽章会链接回本页。
[](https://mcp.popnx.com/en/servers/mnemox-ai-idea-reality-mcp)讨论
提问、分享技巧或报告无法使用。按“有帮助”数量排序。
用户评价
还没有评价
与“开发者工具”中的其他服务器比较i
- 星标数多于此分类中其他 6116 个服务器的 98%
- 发布到注册中心的时间比此分类中其他 6116 个服务器的 4% 更新
- 基础检查结果等于或优于此分类中其他 6116 个服务器的 99%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
Idea Reality MCP 安全吗?
它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在我的电脑上运行还是在云端?
它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。
它还在维护吗?
GitHub 仓库最后更新于2个月前,最新版本(0.3.4)于9个月前进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Python (uv)。
有什么可以替代它?
同一分类中有:GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
功能相近的其他选择
同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| 本项 Idea Reality MCP | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| 运行位置 | 需要安装在电脑上 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 云端或安装在电脑上都可以 |
| 需要密钥 | 否 | 否 | 否 | 否 | 否 | 否 |
| 可在 Claude 中按 + 添加 | 否 | 否 | 否 | 是 | 否 | 否 |
| 基础检查 | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| 许可证 | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| 价格 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 |
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
English | 繁體中文
idea-reality-mcp
How to check if someone already built your app idea — automatically.
idea-reality-mcp is an MCP server that scans GitHub, npm, PyPI, Hacker News, and Stack Overflow to check if your startup idea already exists. It returns a 0–100 reality score with evidence, trend detection, and pivot suggestions — so your AI agent can decide whether to build, pivot, or kill the idea before writing any code.
When to use this: You're about to start a new project and want to know if similar tools already exist, how competitive the space is, and whether the market is growing or declining.
Project status (August 2026): Maintenance mode. The tool works, stays free & open source, and the hosted API remains up; bug reports are reviewed, but no new features are planned.
Not just checking — building it? After a reality check, open your idea as a public project on [AngelRun](https://angelrun.vercel.app/new?utm_source=idea-reality&utm_medium=readme&utm_campaign=demand-cta) — ship updates, climb the season, and get seen by angels.
How it works
- Describe your idea in plain English — e.g. "a CLI tool that converts Figma designs to React components"
- idea_check scans 5 databases in parallel (GitHub repos + stars, Hacker News discussions, npm/PyPI packages, Stack Overflow questions)
- Get a 0–100 reality score with trend direction (accelerating/stable/declining), top competitors, and AI-generated pivot suggestions
What you get
You: "AI code review tool"
idea_check → ├── reality_signal: 92/100 ├── trend: accelerating ↗ ├── market_momentum: 73/100 ├── GitHub repos: 847 (45% created in last 6 months) ├── Top competitor: reviewdog (9,094 ⭐) ├── npm packages: 56 ├── HN discussions: 254 (trending up) └── Verdict: HIGH — market is accelerating, find a niche fast
One score. Six sources. Trend detection. Your agent decides what to do next.
Try it in your browser — no install
Quick Start
# 1. Install
uvx idea-reality-mcp
2. Add to your agent
claude mcp add idea-reality -- uvx idea-reality-mcp # Claude Code
3. Ask your agent: *"Before I start building, check if this already exists: a CLI tool that converts Figma designs to React components"*
That's it. The agent calls idea_check and returns: reality_signal, top competitors, and pivot suggestions.
Other MCP clients
Claude Desktop / Cursor — add to config JSON:
{
"mcpServers": { "idea-reality": { "command": "uvx", "args": ["idea-reality-mcp"] } } }
Config location: macOS ~/Library/Application Support/Claude/claude_desktop_config.json · Windows %APPDATA%\Claude\claude_desktop_config.json · Cursor .cursor/mcp.json
Smithery (remote, no local install):
npx -y @smithery/cli install idea-reality-mcp --client claude
Setup & Configuration
First-time guided setup:
idea-reality setup
This walks you through:
- Terms acceptance — data collection policy and disclaimer
- Platform detection — auto-detects Claude Desktop, Claude Code, Cursor, Windsurf, Cline
- Config generation — prints the exact JSON snippet for your platform
- Health check — verifies MCP server, tools, and scoring engine
Platform Configs
idea-reality config # interactive menu
idea-reality config claude_code # auto-installs via CLI idea-reality config cursor # prints Cursor config idea-reality config raw_json # generic MCP JSON
Supported: Claude Desktop · Claude Code · Cursor · Windsurf · Cline · Smithery · Docker
Health Check
idea-reality doctor # core checks (~2s)
idea-reality doctor --full # + GitHub API, all 6 sources, Anthropic API
Usage
MCP tool call (any MCP-compatible agent):
{
"tool": "idea_check", "arguments": { "idea_text": "a CLI tool that converts Figma designs to React components", "depth": "deep" } }
REST API (no MCP required):
curl -X POST https://idea-reality-mcp.onrender.com/api/check \
-H "Content-Type: application/json" \ -d '{"idea_text": "AI code review tool", "depth": "quick"}'
Python:
import httpx
resp = httpx.post("https://idea-reality-mcp.onrender.com/api/check", json={ "idea_text": "AI code review tool", "depth": "deep" }) print(resp.json()["reality_signal"]) # 0-100
Free. No API key required.
Why not just Google it?
Your AI agent never Googles anything before it starts building. idea_check runs *inside* your agent — it triggers automatically whether you remember or not.
| ChatGPT | idea-reality-mcp | ||
|---|---|---|---|
| Who runs it | You, manually | You, manually | Your agent, automatically |
| Output | 10 blue links | "Sounds promising!" | Score 0-100 + evidence |
| Sources | Web pages | None (LLM) | GitHub + HN + npm + PyPI + PH + SO |
| Price | Free | Paywall | Free & open-source (MIT) |
Modes
| Mode | Sources | Use case |
|---|---|---|
| quick (default) | GitHub + HN | Fast sanity check, < 3 seconds |
| deep | GitHub + HN + npm + PyPI + Stack Overflow | Full competitive scan |
Scoring weights
| Source | Quick | Deep |
|---|---|---|
| GitHub repos | 60% | 22% |
| GitHub stars | 20% | 9% |
| Hacker News | 20% | 14% |
| npm | — | 18% |
| PyPI | — | 13% |
| Stack Overflow | — | 10% |
If a source is unavailable, its weight is redistributed automatically — so the deep-mode weights above are renormalised over the sources that actually answered.
Product Hunt was removed on 2026-07-17. It had carried 14% of the deep-mode weight
since launch and had never returned a single result: the adapter asked for
posts(search: $query), and Product Hunt's API has no text search on posts at all
(
Field 'posts' doesn't accept argument 'search'). Its weight is now redistributed to
sources that answer. If you need it back, it needs a real search surface — not a token.
Tool schema
idea_check
| Parameter | Type | Required | Description | |
|---|---|---|---|---|
idea_text | string | yes | Natural-language description of idea | |
depth | "quick" \ | "deep" | no | "quick" = GitHub + HN (default). "deep" = all 6 sources |
Full output example
{
"reality_signal": 72, "duplicate_likelihood": "high", "trend": "accelerating", "sub_scores": { "market_momentum": 73 }, "evidence": [ {"source": "github", "type": "repo_count", "query": "...", "count": 342}, {"source": "github", "type": "max_stars", "query": "...", "count": 15000}, {"source": "hackernews", "type": "mention_count", "query": "...", "count": 18}, {"source": "npm", "type": "package_count", "query": "...", "count": 56}, {"source": "pypi", "type": "package_count", "query": "...", "count": 23}, {"source": "stackoverflow", "type": "question_count", "query": "...", "count": 120} ], "top_similars": [ {"name": "user/repo", "url": "https://github.com/...", "stars": 15000, "description": "..."} ], "pivot_hints": [ "High competition. Consider a niche differentiator...", "The leading project may have gaps in..." ] }
CI: Auto-check on Pull Requests
Use idea-check-action to validate feature proposals:
name: Idea Reality Check
on: issues: types: [opened]
jobs: check: if: contains(github.event.issue.labels.*.name, 'proposal') runs-on: ubuntu-latest steps:
- uses: mnemox-ai/idea-check-action@v1 with: idea: ${{ github.event.issue.title }} github-token: ${{ secrets.GITHUB_TOKEN }}
Optional config
export GITHUB_TOKEN=ghp_... # Higher GitHub API rate limits
PRODUCTHUNT_TOKEN no longer does anything — the source is disabled and ignores it. Setting it used to be worse than useless: it un-skipped a source whose query the API rejects, so it reported "0 competitors on Product Hunt" into 14% of the deep score.
Auto-trigger: Add one line to your CLAUDE.md, .cursorrules, or .github/copilot-instructions.md:
When starting a new project, use the idea_check MCP tool to check if similar projects already exist.
Roadmap
- v0.1 — GitHub + HN search, basic scoring
- v0.2 — Deep mode (npm, PyPI, Product Hunt), keyword extraction
- v0.3 — 3-stage keyword pipeline, Chinese term mappings, LLM-powered search
- v0.4 — Score History, Agent Templates, GitHub Action
- v0.5 — Temporal signals, trend detection, market momentum
- v0.6 — Onboarding CLI (
idea-reality setup,config,doctor)
Star History
Found a blind spot?
If the tool missed obvious competitors or returned irrelevant results:
- Open an issue with your idea text and the output
- We'll improve the keyword extraction for your domain
Contributing
See CONTRIBUTING.md (繁體中文).
License
MIT — see LICENSE
Built by Mnemox AI · dev@mnemox.ai