idea-reality-mcp
local MCP serveridea-reality-mcp is a local MCP server: Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt — returns 0-100 signal. Install it from pypi as idea-reality-mcp.
Installation
Terminal
claude mcp add idea-reality-mcp -e GITHUB_TOKEN=... -e PRODUCTHUNT_TOKEN=... -- uvx idea-reality-mcp
Run in your project folder. Add --scope user to use it everywhere.
Claude Desktop, Cursor & other clients
Add to claude_desktop_config.json or .cursor/mcp.json.
{
"mcpServers": {
"idea-reality-mcp": {
"command": "uvx",
"args": [
"idea-reality-mcp"
],
"env": {
"GITHUB_TOKEN": "...",
"PRODUCTHUNT_TOKEN": "..."
}
}
}
}Fill in the environment variables with your own credentials.
What you need
- Runtime: Python with uv (runs with uvx).
- MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
- Environment variables:
GITHUB_TOKEN,PRODUCTHUNT_TOKEN
Summary
Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt — returns 0-100 signal.
idea-reality-mcp vs similar servers
| Server | Stars | Type | API key | Runtime |
|---|---|---|---|---|
| idea-reality-mcp | 822 | Local | Yes | pypi |
| COTAL actions (cotal.ai) | 302 | Hosted | No | None |
| directory | 278 | Hosted | No | None |
| pare-build | 138 | Local | No | npm |
| pare-github | 138 | Local | No | npm |
Questions
It reads 2 environment variables: GITHUB_TOKEN, PRODUCTHUNT_TOKEN. Set them in your MCP config before starting the server.
Python with uv (runs with uvx), plus an MCP client such as Claude Code, Codex, Claude Desktop or Cursor.
idea-reality-mcp is a local MCP server distributed as the pypi package idea-reality-mcp.
Run: claude mcp add idea-reality-mcp -e GITHUB_TOKEN=... -e PRODUCTHUNT_TOKEN=... -- uvx idea-reality-mcp
Run: codex mcp add idea-reality-mcp --env GITHUB_TOKEN=... --env PRODUCTHUNT_TOKEN=... -- uvx idea-reality-mcp
Similar MCP servers
NameStars
- COTAL actions (cotal.ai)ai.cotal/cotal302
- directorycom.submitmap/directory278
- pare-buildio.github.Dave-London/pare-build138
- pare-githubio.github.Dave-London/pare-github138
- PostHog MCP Serverio.github.PostHog/mcp40K
- GitHubio.github.github/github-mcp-server33K
- Business Contact Finderagency.ottobot/business-contact-finder7,291
- Contact Affordanceorg.ottobot/contact-affordance7,291