English | 繁體中文
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
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** — ship updates, climb the season, and get seen by angels.
How it works
1. **Describe your idea** in plain English — e.g. "a CLI tool that converts Figma designs to React components"
2. **idea_check scans 5 databases** in parallel (GitHub repos + stars, Hacker News discussions, npm/PyPI packages, Stack Overflow questions)
3. **Get a 0–100 reality score** with trend direction (accelerating/stable/declining), top competitors, and AI-generated pivot suggestions
What you get
One score. Six sources. Trend detection. Your agent decides what to do next.
Try it in your browser — no install
Quick Start
**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:
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):
Setup & Configuration
First-time guided setup:
This walks you through:
1. **Terms acceptance** — data collection policy and disclaimer
2. **Platform detection** — auto-detects Claude Desktop, Claude Code, Cursor, Windsurf, Cline
3. **Config generation** — prints the exact JSON snippet for your platform
4. **Health check** — verifies MCP server, tools, and scoring engine
Platform Configs
Supported: Claude Desktop · Claude Code · Cursor · Windsurf · Cline · Smithery · Docker
Health Check
Usage
**MCP tool call** (any MCP-compatible agent):
**REST API** (no MCP required):
**Python**:
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.
| | Google | 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 |