Idea Reality Mcp

英文 | 繁體中文

idea-reality-mcp

自动检查是否有人已经构建了你的应用创意。

idea-reality-mcp 是一个 MCP 服务，可扫描 GitHub、npm、PyPI、Hacker News 和 Stack Overflow，检查你的创业创意是否已经存在。它会返回 0–100 的现实度评分，并提供证据、趋势检测和转型建议——让你的 AI Agent 在编写任何代码之前，决定是构建、转型还是放弃这个创意。

**适用场景：**你正准备启动一个新项目，想了解是否已有类似工具、这个领域的竞争有多激烈，以及市场是在增长还是衰退。

**项目状态（2026 年 8 月）：**维护模式。工具仍可正常使用，继续免费开源，托管 API 也会继续运行；我们会审查 Bug 报告，但不会计划添加新功能。

**不只是检查——还要构建？**完成现实度检查后，在 AngelRun 上将你的创意作为公开项目发布——发布更新、提升赛季排名，并获得天使投资人的关注。

工作原理

1. 用通俗语言描述你的创意——例如：“一个将 Figma 设计转换为 React 组件的 CLI 工具”
2. idea_check 并行扫描 5 个数据库（GitHub 仓库及星标、Hacker News 讨论、npm/PyPI 软件包、Stack Overflow 问题）
3. 获取 0–100 的现实度评分，包括趋势方向（加速/稳定/衰退）、主要竞争对手以及 AI 生成的转型建议

你将获得

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

一个评分。六个来源。趋势检测。由你的 Agent 决定下一步怎么做。

在浏览器中试用——无需安装

快速开始

# 1. Install
uvx idea-reality-mcp

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

3. 向你的 Agent 提问： “开始构建之前，检查一下这个创意是否已经存在：一个将 Figma 设计转换为 React 组件的 CLI 工具”

就这么简单。Agent 会调用 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 的 Agent）：

{
  "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 Agent 在开始构建之前，从来不会先用 Google 搜索。 idea_check 在你的 Agent 内部运行——无论你是否记得，它都会自动触发。

模式

工具架构

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 会拒绝其查询的来源，导致“Product Hunt 上有 0 个竞品”这一结果被计入深度评分的 14%。

自动触发： 在你的 CLAUDE.md、.cursorrules 或 .github/copilot-instructions.md 中添加一行：

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

路线图

• v0.1 — GitHub + HN 搜索、基础评分
• v0.2 — 深度模式（npm、PyPI、Product Hunt）、关键词提取
• v0.3 — 3 阶段关键词处理流程、中文术语映射、由大模型驱动的搜索
• v0.4 — 评分历史、Agent 模板、GitHub Action
• v0.5 — 时间信号、趋势检测、市场动能
• v0.6 — 入门命令行工具（idea-reality setup、config、doctor）

Star 历史

发现了盲点？

如果工具漏掉了明显的竞品，或返回了无关结果：

1. 提交 issue，附上你的创意文本和输出结果
2. 我们会改进适用于你所在领域的关键词提取

参与贡献

请参阅 CONTRIBUTING.md（繁體中文）。

许可证

MIT — 参见 LICENSE

由 Mnemox AI 构建 · [email protected]