idea-reality-mcp
installs/mo · pypistarsforks
How to install idea-reality-mcp?
mnemox-ai/idea-reality-mcp
$git clone https://github.com/mnemox-ai/idea-reality-mcpEnglish | 繁體中文
README.md
| 1 | <!-- mcp-name: io.github.mnemox-ai/idea-reality-mcp --> |
| 2 | English | [繁體中文](docs/zh/README.zh-TW.md) |
| 3 | |
| 4 | # idea-reality-mcp |
| 5 | |
| 6 | **How to check if someone already built your app idea — automatically.** |
| 7 | |
| 8 | 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. |
| 9 | |
| 10 | **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. |
| 11 | |
| 12 | > **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. |
| 13 | |
| 14 | [](https://pypi.org/project/idea-reality-mcp/) |
| 15 | [](https://smithery.ai/server/idea-reality-mcp) |
| 16 | [](https://opensource.org/licenses/MIT) |
| 17 | []() |
| 18 | [](https://github.com/mnemox-ai/idea-reality-mcp) |
| 19 | [](https://pepy.tech/project/idea-reality-mcp) |
| 20 | |
| 21 | <p align="center"> |
| 22 | <a href="cursor://anysphere.cursor-deeplink/mcp/install?name=idea-reality&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22idea-reality-mcp%22%5D%7D"> |
| 23 | <img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor" height="32"> |
| 24 | </a> |
| 25 | </p> |
| 26 | |
| 27 | ## How it works |
| 28 | |
| 29 | 1. **Describe your idea** in plain English — e.g. "a CLI tool that converts Figma designs to React components" |
| 30 | 2. **idea_check scans 5 databases** in parallel (GitHub repos + stars, Hacker News discussions, npm/PyPI packages, Stack Overflow questions) |
| 31 | 3. **Get a 0–100 reality score** with trend direction (accelerating/stable/declining), top competitors, and AI-generated pivot suggestions |
| 32 | |
| 33 | ## What you get |
| 34 | |
| 35 | ``` |
| 36 | You: "AI code review tool" |
| 37 | |
| 38 | idea_check → |
| 39 | ├── reality_signal: 92/100 |
| 40 | ├── trend: accelerating ↗ |
| 41 | ├── market_momentum: 73/100 |
| 42 | ├── GitHub repos: 847 (45% created in last 6 months) |
| 43 | ├── Top competitor: reviewdog (9,094 ⭐) |
| 44 | ├── npm packages: 56 |
| 45 | ├── HN discussions: 254 (trending up) |
| 46 | └── Verdict: HIGH — market is accelerating, find a niche fast |
| 47 | ``` |
| 48 | |
| 49 | One score. Six sources. Trend detection. Your agent decides what to do next. |
| 50 | |
| 51 | <p align="center"> |
| 52 | <a href="https://mnemox.ai/check"><strong>Try it in your browser — no install</strong></a> |
| 53 | </p> |
| 54 | |
| 55 | ## Quick Start |
| 56 | |
| 57 | ```bash |
| 58 | # 1. Install |
| 59 | uvx idea-reality-mcp |
| 60 | |
| 61 | # 2. Add to your agent |
| 62 | claude mcp add idea-reality -- uvx idea-reality-mcp # Claude Code |
| 63 | ``` |
| 64 | |
| 65 | **3. Ask your agent:** *"Before I start building, check if this already exists: a CLI tool that converts Figma designs to React components"* |
| 66 | |
| 67 | That's it. The agent calls `idea_check` and returns: reality_signal, top competitors, and pivot suggestions. |
| 68 | |
| 69 | <details> |
| 70 | <summary>Other MCP clients</summary> |
| 71 | |
| 72 | **Claude Desktop / Cursor** — add to config JSON: |
| 73 | |
| 74 | ```json |
| 75 | { |
| 76 | "mcpServers": { |
| 77 | "idea-reality": { |
| 78 | "command": "uvx", |
| 79 | "args": ["idea-reality-mcp"] |
| 80 | } |
| 81 | } |
| 82 | } |
| 83 | ``` |
| 84 | |
| 85 | Config location: **macOS** `~/Library/Application Support/Claude/claude_desktop_config.json` · **Windows** `%APPDATA%\Claude\claude_desktop_config.json` · **Cursor** `.cursor/mcp.json` |
| 86 | |
| 87 | **Smithery** (remote, no local install): |
| 88 | |
| 89 | ```bash |
| 90 | npx -y @smithery/cli install idea-reality-mcp --client claude |
| 91 | ``` |
| 92 | |
| 93 | </details> |
| 94 | |
| 95 | ## Setup & Configuration |
| 96 | |
| 97 | First-time guided setup: |
| 98 | |
| 99 | ```bash |
| 100 | idea-reality setup |
| 101 | ``` |
| 102 | |
| 103 | This walks you through: |
| 104 | 1. **Terms acceptance** — data collection policy and disclaimer |
| 105 | 2. **Pl |
People who liked this also viewed
6 picksType
- fastmcp🚀 The fast, Pythonic way to build MCP servers and clients.MCP ServersJul 2026
- playwright-mcpPlaywright MCP serverMCP ServersJul 2026
- ext-appsOfficial repo for spec & SDK of MCP Apps protocol - standard for UIs embedded AI chatbots, served by MCP serversMCP ServersJul 2026
- langchain-mcp-adaptersLangChain 🔌 MCPMCP ServersJul 2026
- mcporterCall MCPs via TypeScript, masquerading as simple TypeScript API. Or package them as cli.MCP ServersJul 2026
- mcp-proxyA bridge between Streamable HTTP and stdio MCP transportsMCP ServersJul 2026
