idea-reality-mcp

English | 繁體中文

idea-reality-mcp

Cómo comprobar si alguien ya construyó la idea de tu aplicación — automáticamente.

idea-reality-mcp es un servidor MCP que escanea GitHub, npm, PyPI, Hacker News y Stack Overflow para comprobar si tu idea de startup ya existe. Devuelve una puntuación de realidad de 0 a 100 con evidencia, detección de tendencias y sugerencias de pivote — para que tu agente de IA pueda decidir si construir, pivotar o descartar la idea antes de escribir cualquier código.

Cuándo usar esto: Estás a punto de comenzar un nuevo proyecto y quieres saber si ya existen herramientas similares, qué tan competitivo es el espacio y si el mercado está creciendo o decayendo.

Estado del proyecto (agosto de 2026): Modo de mantenimiento. La herramienta funciona, sigue siendo gratuita y de código abierto, y la API alojada permanece activa; los informes de errores se revisan, pero no se planean nuevas funciones.

¿No solo comprobar, sino construir? Después de una verificación de realidad, abre tu idea como un proyecto público en AngelRun — publica actualizaciones, sube en la temporada y hazte visible para los ángeles.

Cómo funciona

1. Describe tu idea en inglés sencillo — p. ej., "una herramienta CLI que convierte diseños de Figma en componentes de React"
2. idea_check escanea 5 bases de datos en paralelo (repositorios de GitHub + estrellas, discusiones de Hacker News, paquetes de npm/PyPI, preguntas de Stack Overflow)
3. Obtén una puntuación de realidad de 0 a 100 con dirección de tendencia (acelerando/estable/decayendo), principales competidores y sugerencias de pivote generadas por IA

Lo que obtienes

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

Una puntuación. Seis fuentes. Detección de tendencias. Tu agente decide qué hacer a continuación.

Pruébalo en tu navegador — sin instalación

Inicio rápido

# 1. Install
uvx idea-reality-mcp

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

3. Pregunta a tu agente: "Antes de empezar a construir, comprueba si esto ya existe: una herramienta CLI que convierte diseños de Figma en componentes de React"

Eso es todo. El agente llama a idea_check y devuelve: reality_signal, principales competidores y sugerencias de pivote.

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

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

Configuración

Configuración guiada por primera vez:

idea-reality setup

Esto te guía a través de:

1. Aceptación de términos — política de recopilación de datos y descargo de responsabilidad
2. Detección de plataforma — detecta automáticamente Claude Desktop, Claude Code, Cursor, Windsurf, Cline
3. Generación de configuración — imprime el fragmento JSON exacto para tu plataforma
4. Verificación de salud — verifica el servidor MCP, las herramientas y el motor de puntuación

Configuraciones de plataforma

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

Compatibles: Claude Desktop · Claude Code · Cursor · Windsurf · Cline · Smithery · Docker

Verificación de salud

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

Uso

Llamada a herramienta MCP (cualquier agente compatible con MCP):

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

API REST (sin necesidad de 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

Gratis. No se requiere clave de API.

¿Por qué no simplemente buscarlo en Google?

Tu agente de IA nunca busca en Google antes de empezar a construir. idea_check se ejecuta dentro de tu agente — se activa automáticamente, lo recuerdes o no.

Modos

Esquema de la herramienta

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: Verificación automática en solicitudes de extracción

Usa idea-check-action para validar propuestas de funciones:

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

Configuración opcional

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

PRODUCTHUNT_TOKEN ya no hace nada — la fuente está deshabilitada y lo ignora. Configurarlo solía ser peor que inútil: des-saltaba una fuente cuya consulta la API rechaza, por lo que informaba "0 competidores en Product Hunt" en el 14% de la puntuación profunda.

Activación automática: Añade una línea a tu CLAUDE.md, .cursorrules o .github/copilot-instructions.md:

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

Hoja de ruta

• v0.1 — Búsqueda en GitHub + HN, puntuación básica
• v0.2 — Modo profundo (npm, PyPI, Product Hunt), extracción de palabras clave
• v0.3 — Pipeline de palabras clave de 3 etapas, mapeos de términos en chino, búsqueda impulsada por LLM
• v0.4 — Historial de puntuación, plantillas de agente, acción de GitHub
• v0.5 — Señales temporales, detección de tendencias, impulso del mercado
• v0.6 — CLI de incorporación (idea-reality setup, config, doctor)

Historial de estrellas

¿Encontraste un punto ciego?

Si la herramienta omitió competidores obvios o devolvió resultados irrelevantes:

1. Abre un problema con el texto de tu idea y la salida
2. Mejoraremos la extracción de palabras clave para tu dominio

Contribuciones

Consulta CONTRIBUTING.md (繁體中文).

Licencia

MIT — consulta LICENSE

Construido por Mnemox AI · dev@mnemox.ai