idea-reality-mcp MCP工具

1. Install

uvx idea-reality-mcp

Setup & Configuration

First-time guided setup:

idea-reality 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

Quick Start

```bash

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.

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

Optional config

export GITHUB_TOKEN=ghp_...        # Higher GitHub API rate limits
export PRODUCTHUNT_TOKEN=your_...  # Enable Product Hunt (deep mode)

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.