Idea Reality Mcp

English | 繁體中文

idea-reality-mcp

あなたのアプリのアイデアがすでに誰かによって実現されているか、自動で確認できます。

idea-reality-mcp は、GitHub、npm、PyPI、Hacker News、Stack Overflow をスキャンして、あなたのスタートアップのアイデアがすでに存在するかを確認する MCP サーバーです。根拠、トレンド検出、方向転換の提案とともに、0～100 のリアリティスコアを返すため、AI エージェントはコードを書く前に、そのアイデアを実現するか、方向転換するか、断念するかを判断できます。

こんなときに使います： 新しいプロジェクトを始めようとしていて、似たツールがすでに存在するか、競争がどれほど激しいか、市場が成長中か衰退中かを知りたいとき。

プロジェクトの状況（2026年8月）： メンテナンスモードです。ツールは引き続き動作し、無料のオープンソースとして提供され、ホスト型 API も稼働しています。バグ報告は確認しますが、新機能の追加予定はありません。

確認するだけでなく、実際に作りますか？ リアリティチェックの後、アイデアを AngelRun で公開プロジェクトとして始めましょう。アップデートを公開し、シーズンのランキングを上げ、エンジェル投資家に見つけてもらいましょう。

仕組み

1. アイデアを説明します — たとえば、「Figma のデザインを React コンポーネントに変換する CLI ツール」
2. idea_check が5つのデータベースを並列スキャンします（GitHub リポジトリとスター数、Hacker News の議論、npm／PyPI パッケージ、Stack Overflow の質問）
3. トレンドの方向（加速／安定／衰退）、競合上位、AI が生成した方向転換の提案とともに、0～100 のリアリティスコアを取得できます

得られるもの

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

1つのスコア。6つの情報源。トレンド検出。次に何をするかは、エージェントが判断します。

ブラウザーで試す — インストール不要

クイックスタート

# 1. Install
uvx idea-reality-mcp

# 2. Add to your agent
claude mcp add idea-reality -- uvx idea-reality-mcp   # Claude Code

3. エージェントに質問します： 「作り始める前に、これがすでに存在するか確認してください。Figma のデザインを React コンポーネントに変換する CLI ツールです」

これで完了です。エージェントが idea_check を呼び出し、reality_signal、競合上位、方向転換の提案を返します。

{
  "mcpServers": {
    "idea-reality": {
      "command": "uvx",
      "args": ["idea-reality-mcp"]
    }
  }
}

npx -y @smithery/cli install idea-reality-mcp --client claude

セットアップと設定

初回のガイド付きセットアップ：

idea-reality setup

次の手順を案内します：

1. 利用規約への同意 — データ収集ポリシーと免責事項
2. プラットフォームの検出 — Claude Desktop、Claude Code、Cursor、Windsurf、Cline を自動検出します
3. 設定の生成 — 使用するプラットフォームに必要な JSON スニペットを正確に表示します
4. ヘルスチェック — MCP サーバー、ツール、スコアリングエンジンが動作することを確認します

プラットフォーム別の設定

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

対応環境：Claude Desktop · Claude Code · Cursor · Windsurf · Cline · Smithery · Docker

ヘルスチェック

idea-reality doctor        # core checks (~2s)
idea-reality doctor --full # + GitHub API, all 6 sources, Anthropic API

使用方法

MCP ツールの呼び出し（MCP 互換エージェント）：

{
  "tool": "idea_check",
  "arguments": {
    "idea_text": "a CLI tool that converts Figma designs to React components",
    "depth": "deep"
  }
}

REST API（MCP は不要）：

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

無料です。API キーは必要ありません。

Google で検索するだけでは不十分な理由

AI エージェントは、開発を始める前に Google 検索をしません。 idea_check はエージェント内で実行されるため、あなたが覚えているかどうかにかかわらず自動的に起動します。

モード

ツールのスキーマ

idea_check

{
  "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：プルリクエストで自動チェック

idea-check-action を使って、機能の提案を検証します。

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 }}

オプション設定

export GITHUB_TOKEN=ghp_...        # Higher GitHub API rate limits

PRODUCTHUNT_TOKEN は現在、何の効果もありません。ソースは無効化されており、この設定は無視されます。 以前は、設定すると役に立たないどころか、API が拒否するクエリを使うソースのスキップが解除され、deep スコアの14%に「Product Hunt には競合が0件」と報告される状態になっていました。

自動起動： CLAUDE.md、.cursorrules、または .github/copilot-instructions.md に1行追加します。

When starting a new project, use the idea_check MCP tool to check if similar projects already exist.

ロードマップ

• v0.1 — GitHub ＋ HN 検索、基本的なスコアリング
• v0.2 — Deep モード（npm、PyPI、Product Hunt）、キーワード抽出
• v0.3 — 3段階のキーワード処理パイプライン、中国語の用語マッピング、LLM を活用した検索
• v0.4 — スコア履歴、エージェントテンプレート、GitHub Action
• v0.5 — 時系列シグナル、トレンド検出、市場の勢い
• v0.6 — オンボーディング CLI（idea-reality setup、config、doctor）

スター履歴

見落としを見つけましたか？

明らかな競合をツールが見逃した場合や、無関係な結果を返した場合：

1. アイデアのテキストと出力を添えて、イシューを作成してください
2. 該当分野のキーワード抽出を改善します

コントリビューション

CONTRIBUTING.md（繁體中文）をご覧ください。

ライセンス

MIT — LICENSE をご覧ください。

Mnemox AI が開発 · [email protected]