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 に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
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 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
uv --version一度入れれば、uv を使うすべてのツールで使えます
パソコン版 Claude アプリの設定ファイルを開く
SettingsDeveloperEdit Config
この設定を貼り付けて保存
{ "mcpServers": { "idea-reality": { "command": "uvx", "args": [ "idea-reality-mcp" ] } } }Claude を終了してもう一度開く
試してみる
Idea Reality MCP を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が Idea Reality MCP を使っていると言うか、回答に Idea Reality MCP のツール名が出れば接続成功です
追加の設定 2 項目(入力しなくても使えます)
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ Idea Reality MCP につなげません
Idea Reality MCP はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
代わりにできること
A · Idea Reality MCP につなげるアプリを使う
- 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
- 先にパソコンへ Python (uv) を入れてください(1 回だけ)
- 先にパソコンへ Python (uv) を入れてください(1 回だけ)
- 先にパソコンへ Python (uv) を入れてください(1 回だけ)
B · 開発者ツール の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Claude Code につなげますが、先に準備が必要です
先にパソコンへ Python (uv) を入れてください(1 回だけ)
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 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
uv --version一度入れれば、uv を使うすべてのツールで使えます
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
このコマンドを貼り付けて Enter
claude mcp add --scope user idea-reality -- uvx idea-reality-mcpClaude Code で /mcp と入力
Idea Reality MCP が一覧にあり、接続済みと表示されれば OK です
試してみる
Idea Reality MCP を使って、私に何ができるか教えて、1 つやってみせて✓ 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) を入れてください(1 回だけ)
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 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
uv --version一度入れれば、uv を使うすべてのツールで使えます
Cursor の AI チャットを Agent モードで開く
試してみる
Idea Reality MCP を使って、私に何ができるか教えて、1 つやってみせて✓ 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) を入れてください(1 回だけ)
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 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
uv --version一度入れれば、uv を使うすべてのツールで使えます
VS Code の AI チャットを Agent モードで開く
試してみる
Idea Reality MCP を使って、私に何ができるか教えて、1 つやってみせて✓ 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 のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
開発者向け:ターミナルのコマンドと 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月18日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有する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
- このカテゴリのほかの6103件のうち98%よりスターが多い
- このカテゴリのほかの6103件のうち4%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの6103件のうち99%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
Idea Reality MCPは安全ですか?
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は2 か月前、最新バージョン(0.3.4)がレジストリに届いたのは9 か月前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。
代わりに使えるものは?
同じカテゴリには:GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
似た働きのほかの候補
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況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