{"id":45694094,"url":"https://github.com/mnemox-ai/idea-reality-mcp","last_synced_at":"2026-03-02T19:01:32.856Z","repository":{"id":340404701,"uuid":"1165625901","full_name":"mnemox-ai/idea-reality-mcp","owner":"mnemox-ai","description":"Pre-build reality check for AI coding agents. Scans GitHub, HN, npm, PyPI \u0026 Product Hunt — returns a 0-100 reality signal. MCP tool. Try: mnemox.ai/check","archived":false,"fork":false,"pushed_at":"2026-03-01T14:30:38.000Z","size":990,"stargazers_count":219,"open_issues_count":0,"forks_count":17,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-01T19:11:14.895Z","etag":null,"topics":["ai","developer-tools","github","hackernews","mcp","model-context-protocol","npm","producthunt","pypi","reality-check"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mnemox-ai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-24T11:16:50.000Z","updated_at":"2026-03-01T14:30:42.000Z","dependencies_parsed_at":"2026-02-28T17:00:40.641Z","dependency_job_id":null,"html_url":"https://github.com/mnemox-ai/idea-reality-mcp","commit_stats":null,"previous_names":["mnemox-ai/idea-reality-mcp"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/mnemox-ai/idea-reality-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnemox-ai%2Fidea-reality-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnemox-ai%2Fidea-reality-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnemox-ai%2Fidea-reality-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnemox-ai%2Fidea-reality-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mnemox-ai","download_url":"https://codeload.github.com/mnemox-ai/idea-reality-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mnemox-ai%2Fidea-reality-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30016506,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-02T17:00:27.440Z","status":"ssl_error","status_checked_at":"2026-03-02T17:00:03.402Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","developer-tools","github","hackernews","mcp","model-context-protocol","npm","producthunt","pypi","reality-check"],"created_at":"2026-02-24T19:03:20.020Z","updated_at":"2026-03-02T19:01:32.648Z","avatar_url":"https://github.com/mnemox-ai.png","language":"Python","funding_links":[],"categories":["カテゴリ","Research \u0026 Academic Mcp Servers","🔬 Research (7 servers)"],"sub_categories":["🔍 \u003ca name=\"search--knowledge\"\u003e\u003c/a\u003e検索・ナレッジ"],"readme":"\u003c!-- mcp-name: io.github.mnemox-ai/idea-reality-mcp --\u003e\nEnglish | [繁體中文](README.zh-TW.md)\n\n# idea-reality-mcp\n\n**We search. They guess.**\n\nThe only idea validator that searches real data. 5 sources. Quantified signal. Zero hallucination.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)\n[![MCP](https://img.shields.io/badge/MCP-compatible-green.svg)](https://modelcontextprotocol.io/)\n[![PyPI](https://img.shields.io/pypi/v/idea-reality-mcp.svg)](https://pypi.org/project/idea-reality-mcp/)\n[![Smithery](https://smithery.ai/badge/idea-reality-mcp)](https://idea-reality-mcp--mnemox-ai.run.tools)\n[![GitHub stars](https://img.shields.io/github/stars/mnemox-ai/idea-reality-mcp)](https://github.com/mnemox-ai/idea-reality-mcp)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/demo_flow.gif\" alt=\"idea-reality-mcp demo\" width=\"600\" /\u003e\n\u003c/p\u003e\n\n## The problem\n\nEvery developer has wasted days building something that already exists with 5,000 stars on GitHub.\n\nYou ask ChatGPT: *\"Is there already a tool that does X?\"*\n\nChatGPT says: *\"That's a great idea! There are some similar tools, but you can definitely build something better!\"*\n\n**That's not validation. That's cheerleading.**\n\n## What we do instead\n\n```\nYou: \"AI code review tool\"\n\nidea-reality-mcp:\n├── reality_signal: 90/100\n├── GitHub repos: 847\n├── Top competitor: reviewdog (9,094 ⭐)\n├── npm packages: 56\n├── HN discussions: 254\n└── Verdict: HIGH — consider pivoting to a niche\n```\n\nOne gives you encouragement. The other gives you facts.\n\n**Which one do you trust your next 3 months on?**\n\n## Try it now (30 seconds)\n\n```bash\nuvx idea-reality-mcp\n```\n\nOr [try it in your browser](https://mnemox.ai/check) — no install required.\n\n## Why not just ask ChatGPT?\n\n| | idea-reality-mcp | ChatGPT / ValidatorAI / IdeaProof |\n|---|---|---|\n| **Data source** | GitHub + HN + npm + PyPI + Product Hunt (real-time) | LLM generation (no real source searched) |\n| **Output** | Score 0-100 + real projects with star counts | Text opinion (\"Sounds promising!\") |\n| **Verifiable** | Every number has a source | Not verifiable |\n| **Integration** | MCP / CLI / API / Web | Web-only |\n| **Price** | Free, open-source, forever | Free trial → paywall |\n| **Audience** | Developers (before writing code) | Non-technical founders (before writing pitch decks) |\n\n**TL;DR — We search 5 real databases. They generate opinions.**\n\n## New: AI-powered search intelligence\n\n**Claude Haiku 4.5** now generates optimal search queries from your idea description — in any language — with automatic fallback to our battle-tested dictionary pipeline.\n\n| | Before | Now |\n|---|---|---|\n| English ideas | ✅ Good | ✅ Good |\n| Chinese / non-English ideas | ⚠️ Dictionary lookup (150+ terms) | ✅ Native understanding |\n| Ambiguous descriptions | ⚠️ Keyword matching | ✅ Semantic extraction |\n| Reliability | 100% (no external API) | 100% (graceful fallback to dictionary) |\n\nThe LLM understands your idea. The dictionary is your safety net. **You always get results.**\n\n## Make your AI agent check automatically\n\nAdd this to your `.claude/instructions.md` or `CLAUDE.md`:\n\n```\nBefore building any new tool, feature, or project,\nalways run idea_check first to verify the idea hasn't been built already.\n```\n\n**This is the highest-ROI setup.** Your AI agent will validate ideas before writing a single line of code. Install once, protect every project.\n\n## Install (5 minutes)\n\n### Claude Desktop\n\nPaste into `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"idea-reality\": {\n      \"command\": \"uvx\",\n      \"args\": [\"idea-reality-mcp\"]\n    }\n  }\n}\n```\n\n### Cursor\n\nPaste into `.cursor/mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"idea-reality\": {\n      \"command\": \"uvx\",\n      \"args\": [\"idea-reality-mcp\"]\n    }\n  }\n}\n```\n\n### Claude Code (CLI)\n\n```bash\nclaude mcp add idea-reality -- uvx idea-reality-mcp\n```\n\n### Smithery (Remote)\n\n```bash\nnpx -y @smithery/cli install idea-reality-mcp --client claude\n```\n\n### Optional: Environment variables\n\n```bash\nexport GITHUB_TOKEN=ghp_...        # Higher GitHub API rate limits\nexport PRODUCTHUNT_TOKEN=your_...  # Enable Product Hunt (deep mode)\n```\n\n## Usage\n\n### \"I have a side project idea — should I build it?\"\n\nTell your AI agent:\n\n```\nBefore I start building, check if this already exists:\na CLI tool that converts Figma designs to React components\n```\n\nThe agent calls `idea_check` and returns: reality_signal, top competitors, and pivot suggestions.\n\n### \"Find competitors and alternatives\"\n\n```\nidea_check(\"open source feature flag service\", depth=\"deep\")\n```\n\nDeep mode scans all 5 sources in parallel — GitHub repos, HN discussions, npm packages, PyPI packages, and Product Hunt — and returns ranked results.\n\n### \"Build-or-buy sanity check before a sprint\"\n\n```\nWe're about to spend 2 weeks building an internal error tracking tool.\nRun a reality check first.\n```\n\nIf the signal comes back at 85+ with mature open-source alternatives, you just saved your team 2 weeks.\n\n## Tool schema\n\n### `idea_check`\n\n| Parameter   | Type                      | Required | Description                          |\n|-------------|---------------------------|----------|--------------------------------------|\n| `idea_text` | string                    | yes      | Natural-language description of idea |\n| `depth`     | `\"quick\"` \\| `\"deep\"`     | no       | `\"quick\"` = GitHub + HN (default). `\"deep\"` = all 5 sources in parallel |\n\n**Output:** `reality_signal` (0-100), `duplicate_likelihood`, `evidence[]`, `top_similars[]`, `pivot_hints[]`, `meta{}`\n\n\u003cdetails\u003e\n\u003csummary\u003eFull output example\u003c/summary\u003e\n\n```json\n{\n  \"reality_signal\": 72,\n  \"duplicate_likelihood\": \"high\",\n  \"evidence\": [\n    {\"source\": \"github\", \"type\": \"repo_count\", \"query\": \"...\", \"count\": 342},\n    {\"source\": \"github\", \"type\": \"max_stars\", \"query\": \"...\", \"count\": 15000},\n    {\"source\": \"hackernews\", \"type\": \"mention_count\", \"query\": \"...\", \"count\": 18},\n    {\"source\": \"npm\", \"type\": \"package_count\", \"query\": \"...\", \"count\": 56},\n    {\"source\": \"pypi\", \"type\": \"package_count\", \"query\": \"...\", \"count\": 23},\n    {\"source\": \"producthunt\", \"type\": \"product_count\", \"query\": \"...\", \"count\": 8}\n  ],\n  \"top_similars\": [\n    {\"name\": \"user/repo\", \"url\": \"https://github.com/...\", \"stars\": 15000, \"description\": \"...\"}\n  ],\n  \"pivot_hints\": [\n    \"High competition. Consider a niche differentiator...\",\n    \"The leading project may have gaps in...\",\n    \"Consider building an integration or plugin...\"\n  ],\n  \"meta\": {\n    \"sources_used\": [\"github\", \"hackernews\", \"npm\", \"pypi\", \"producthunt\"],\n    \"keyword_source\": \"llm\",\n    \"depth\": \"deep\",\n    \"version\": \"0.3.2\"\n  }\n}\n```\n\n\u003c/details\u003e\n\n### Scoring weights\n\n| Mode | GitHub repos | GitHub stars | HN | npm | PyPI | Product Hunt |\n|------|-------------|-------------|-----|-----|------|-------------|\n| Quick | 60% | 20% | 20% | — | — | — |\n| Deep | 25% | 10% | 15% | 20% | 15% | 15% |\n\nIf Product Hunt is unavailable (no token), its weight is redistributed automatically.\n\n## CI: Auto-check on Pull Requests\n\nAdd `.github/workflows/idea-check.yml` to run reality checks when PRs propose new features:\n\n```yaml\nname: Idea Reality Check\non:\n  pull_request:\n    paths: ['docs/proposals/**', 'RFC/**']\n\njobs:\n  check:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - uses: actions/setup-python@v5\n        with:\n          python-version: '3.11'\n      - run: pip install idea-reality-mcp httpx\n      - name: Run idea check\n        env:\n          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n        run: |\n          python -c \"\n          import asyncio, json\n          from idea_reality_mcp.sources.github import search_github_repos\n          from idea_reality_mcp.sources.hn import search_hn\n          from idea_reality_mcp.scoring.engine import compute_signal, extract_keywords\n\n          async def main():\n              idea = open('docs/proposals/latest.md').read()[:500]\n              kw = extract_keywords(idea)\n              gh = await search_github_repos(kw)\n              hn = await search_hn(kw)\n              report = compute_signal(gh, hn)\n              print(json.dumps(report, indent=2))\n\n          asyncio.run(main())\n          \"\n      - name: Comment on PR\n        if: always()\n        uses: actions/github-script@v7\n        with:\n          script: |\n            github.rest.issues.createComment({\n              owner: context.repo.owner,\n              repo: context.repo.repo,\n              issue_number: context.issue.number,\n              body: '## Idea Reality Check\\nSee workflow run for full report.'\n            })\n```\n\n## Roadmap\n\n- [x] **v0.1** — GitHub + HN search, basic scoring\n- [x] **v0.2** — Deep mode (npm, PyPI, Product Hunt), improved keyword extraction\n- [x] **v0.3** — 3-stage keyword pipeline, 150+ Chinese term mappings, synonym expansion, LLM-powered search (Render API)\n- [ ] **v0.4** — Trend detection and timing analysis\n- [ ] **v1.0** — Idea Memory Dataset (opt-in anonymous logging)\n\n## Found a blind spot?\n\nIf the tool missed obvious competitors or returned irrelevant results:\n\n1. [Open an issue](https://github.com/mnemox-ai/idea-reality-mcp/issues/new?template=inaccurate-result.yml) with your idea text and the output\n2. We'll improve the keyword extraction for your domain\n\n## License\n\nMIT — see [LICENSE](LICENSE)\n\n## Contact\n\nBuilt by [Mnemox AI](https://mnemox.ai) · [dev@mnemox.ai](mailto:dev@mnemox.ai)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmnemox-ai%2Fidea-reality-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmnemox-ai%2Fidea-reality-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmnemox-ai%2Fidea-reality-mcp/lists"}