idea-reality-mcp

English | 繁體中文

idea-reality-mcp

Como verificar se alguém já construiu a sua ideia de aplicativo — automaticamente.

idea-reality-mcp é um servidor MCP que verifica GitHub, npm, PyPI, Hacker News e Stack Overflow para checar se a sua ideia de startup já existe. Ele retorna uma pontuação de realidade de 0 a 100 com evidências, detecção de tendências e sugestões de pivô — para que seu agente de IA possa decidir se deve construir, pivotar ou descartar a ideia antes de escrever qualquer código.

Quando usar isso: Você está prestes a iniciar um novo projeto e quer saber se ferramentas semelhantes já existem, quão competitivo é o espaço e se o mercado está crescendo ou diminuindo.

Status do projeto (agosto de 2026): Modo de manutenção. A ferramenta funciona, permanece gratuita e de código aberto, e a API hospedada continua no ar; relatórios de bugs são revisados, mas nenhum novo recurso está planejado.

Não é só verificar — está construindo? Após uma verificação de realidade, abra sua ideia como um projeto público no AngelRun — publique atualizações, suba na temporada e seja visto por anjos.

Como funciona

1. Descreva sua ideia em linguagem simples — ex.: "uma ferramenta CLI que converte designs do Figma em componentes React"
2. idea_check verifica 5 bancos de dados em paralelo (repositórios GitHub + estrelas, discussões no Hacker News, pacotes npm/PyPI, perguntas no Stack Overflow)
3. Obtenha uma pontuação de realidade de 0 a 100 com direção de tendência (acelerando/estável/declinando), principais concorrentes e sugestões de pivô geradas por IA

O que você obtém

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

Uma pontuação. Seis fontes. Detecção de tendências. Seu agente decide o que fazer a seguir.

Experimente no seu navegador — sem instalação

Início 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. Pergunte ao seu agente: "Antes de eu começar a construir, verifique se isso já existe: uma ferramenta CLI que converte designs do Figma em componentes React"

É isso. O agente chama idea_check e retorna: reality_signal, principais concorrentes e sugestões de pivô.

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

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

Configuração

Configuração guiada pela primeira vez:

idea-reality setup

Isso orienta você por:

1. Aceitação dos termos — política de coleta de dados e aviso legal
2. Detecção de plataforma — detecta automaticamente Claude Desktop, Claude Code, Cursor, Windsurf, Cline
3. Geração de configuração — imprime o trecho JSON exato para sua plataforma
4. Verificação de saúde — verifica o servidor MCP, as ferramentas e o mecanismo de pontuação

Configurações por 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

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

Verificação de Saúde

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

Uso

Chamada de ferramenta MCP (qualquer agente compatível com MCP):

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

API REST (sem necessidade 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

Gratuito. Nenhuma chave de API necessária.

Por que não simplesmente pesquisar no Google?

Seu agente de IA nunca pesquisa no Google antes de começar a construir. idea_check roda dentro do seu agente — ele é acionado automaticamente, quer você lembre ou não.

Modos

Esquema da ferramenta

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: Verificação automática em Pull Requests

Use idea-check-action para validar propostas de recursos:

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

Configuração opcional

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

PRODUCTHUNT_TOKEN não faz mais nada — a fonte está desativada e o ignora. Defini-lo costumava ser pior que inútil: ele reativava uma fonte cuja consulta a API rejeita, então relatava "0 concorrentes no Product Hunt" em 14% da pontuação deep.

Acionamento automático: Adicione uma linha ao seu CLAUDE.md, .cursorrules ou .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 — Busca GitHub + HN, pontuação básica
• v0.2 — Modo deep (npm, PyPI, Product Hunt), extração de palavras-chave
• v0.3 — Pipeline de palavras-chave em 3 estágios, mapeamentos de termos em chinês, busca com LLM
• v0.4 — Histórico de pontuação, modelos de agente, GitHub Action
• v0.5 — Sinais temporais, detecção de tendências, momentum de mercado
• v0.6 — CLI de integração (idea-reality setup, config, doctor)

Histórico de Estrelas

Encontrou um ponto cego?

Se a ferramenta deixou passar concorrentes óbvios ou retornou resultados irrelevantes:

1. Abra uma issue com o texto da sua ideia e a saída
2. Melhoraremos a extração de palavras-chave para o seu domínio

Contribuindo

Veja CONTRIBUTING.md (繁體中文).

Licença

MIT — veja LICENSE

Construído por Mnemox AI · dev@mnemox.ai