用途
idea-reality-mcp 是一个 MCP（Model Context Protocol）服务器，定位为“AI 编程智能体的构建前现实检查”。当你准备启动一个新项目时，它可以帮助你判断类似工具是否已经存在、该领域竞争有多激烈，以及市场是在增长还是衰退。
主要能力
- 用自然语言描述你的想法，例如“一个把 Figma 设计转换成 React 组件的 CLI 工具”。
- idea_check 会并行扫描 5 个数据库：GitHub 仓库及 star 数、Hacker News 讨论、npm/PyPI 包、Stack Overflow 问题。
- 返回 0–100 的现实评分，并附带趋势方向（accelerating/stable/declining）、主要竞争对手和 AI 生成的转型建议。
- 一个评分，六个来源，趋势检测，由你的智能体决定下一步怎么做。
- 如果某个来源不可用，其权重会自动重新分配，因此深度模式的权重会在实际返回结果的来源上重新归一化。
- 支持通过 GitHub Action 在 Pull Request 上自动检查功能提案。
使用方式
- 在浏览器中试用，无需安装。
- 向你的智能体提问：“在我开始构建之前，检查一下这个是否已经存在：一个把 Figma 设计转换成 React 组件的 CLI 工具”。智能体会调用 idea_check，并返回 reality_signal、主要竞争对手和转型建议。
- Claude Desktop / Cursor：添加到配置 JSON。配置位置：macOS 为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 为 %APPDATA%\Claude\claude_desktop_config.json，Cursor 为 .cursor/mcp.json。
- Smithery（远程，无需本地安装）。
- 首次引导设置：运行 idea-reality setup，会引导你完成条款接受（数据收集政策与免责声明）、平台检测（自动检测 Claude Desktop、Claude Code、Cursor、Windsurf、Cline）、配置生成（打印适用于你平台的精确 JSON 片段）、健康检查（验证 MCP 服务器、工具和评分引擎）。
- 支持的平台：Claude Desktop、Claude Code、Cursor、Windsurf、Cline、Smithery、Docker。
- 任意兼容 MCP 的智能体可进行 MCP 工具调用；也可使用 REST API（无需 MCP），免费，无需 API key。
- 自动触发：在 CLAUDE.md、.cursorrules 或 .github/copilot-instructions.md 中添加一行即可。
适用场景
- 即将开始一个新项目，想知道是否已有类似工具。
- 想了解某个领域的竞争程度。
- 想判断市场是在增长还是衰退。
- 在 Pull Request 中验证功能提案是否与已有项目重复。
限制与说明
- 项目状态（2026 年 8 月）：维护模式。工具可用，保持免费开源，托管 API 保持在线；会审查 bug 报告，但不计划新增功能。
- Product Hunt 已于 2026-07-17 移除。它自发布以来一直占深度模式权重的 14%，但从未返回过任何结果：适配器请求 posts(search: $query)，而 Product Hunt 的 API 根本不支持对 posts 做文本搜索（Field 'posts' doesn't accept argument 'search'）。其权重现已重新分配给能够返回结果的来源。
- PRODUCTHUNT_TOKEN 不再起作用——该来源已禁用并忽略它。
- 版本历史：v0.1 GitHub + HN 搜索、基础评分；v0.2 深度模式（npm、PyPI、Product Hunt）、关键词提取；v0.3 三阶段关键词流水线、中文术语映射、LLM 驱动的搜索；v0.4 评分历史、智能体模板、GitHub Action；v0.5 时间信号、趋势检测、市场动量；v0.6 引导 CLI（idea-reality setup、config、doctor）。
- 许可证：MIT。由 Mnemox AI 构建，联系邮箱 dev@mnemox.ai。
- 如果工具漏掉了明显的竞争对手或返回了不相关结果，可以提交 issue，附上你的想法文本和输出。
