Readhn

io.github.xodn348由 GitHub 账号 xodn348 发布v0.2.0更新于 Oct 24, 2026

AI-native HackerNews MCP Server. Find HN content that matters with explainable quality signals.

已验证STDIO仅桌面网页搜索与抓取数据与分析

概览

AI 生成的概览

本地 MCP 服务器，让 AI 助手搜索 Hacker News、按可解释的质量信号对故事排序，并识别评论区的领域专家。

可以做什么
发现与搜索故事：按关键词、分数和时间窗口筛选，或使用 Algolia 搜索，返回带质量信号的排序结果。分析讨论串：一次获取故事及热门评论，或获取带逐条评论信号的完整评论树。分析人物：通过从种子专家出发的 EigenTrust 传播寻找领域专家，并获取包含活跃度与信任分的用户画像。解释结果：每个响应都包含五项信号（实践深度、讨论深度、专家参与、热度、引用）的分解。
适用场景
适合让助手回答关于 Hacker News 讨论的问题，例如某话题的热门故事、讨论串中实践者的观点，或某领域谁写得可信，并给出每条结果的排序理由，而不只是列表。
运行要求
以 Python 包通过 pip 安装，作为本地进程经 stdio 运行。未声明认证或 API 密钥。可选环境变量用于调整默认值：HN_KEYWORDS、HN_MIN_SCORE、HN_EXPERTS、HN_TIME_HOURS。setup 命令可向支持的 AI 客户端写入配置。需要访问 Hacker News 的网络连接。
安装前请注意
setup 命令会修改检测到的 AI 代理的配置文件，建议先用 dry-run 预览。查询内容和抓取的 Hacker News 内容会与第三方服务（Hacker News 及 Algolia 搜索）交互。排序信号是启发式指标，并非经过验证的质量判断。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Readhn，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

readhn

[PyPI] [Tests] [Coverage] [MCP]

AI-native HackerNews MCP Server. Find HN content that matters with explainable quality signals.

What It Does

Discover — Filter stories by keywords, scores, time. Get ranked results with quality signals.

Trust — Find domain experts. See who's talking and why they matter. EigenTrust propagation from seed experts.

Understand — Every result explains WHY. 5 signals: practitioner depth (30%), thread depth (20%), expert involvement (20%), velocity (15%), references (15%).

Quick Start

bash
# Installpip install readhn
# Auto-configure supported AI agentsreadhn setup

readhn setup detects Claude Code, Codex, Cursor, Claude Desktop, Cline, Windsurf, and OpenCode config paths and adds the readhn MCP server.

Useful setup flags:

bash
readhn setup --list              # Show detected agentsreadhn setup --dry-run           # Preview config changes onlyreadhn setup --agents "Cursor"  # Configure only specific agents

After setup, your AI agent auto-discovers readhn and uses it when you ask HN questions.

Usage

Ask your AI agent:

  • "Show me top HN stories about Rust this week"
  • "Find experts who write about databases on HN"
  • "What did practitioners say about Kubernetes networking?"

The agent calls readhn tools, gets results with quality signals, and explains why each result matters.

Configuration (Optional)

bash
export HN_KEYWORDS="ai,llm,rust,distributed-systems,databases"  # Default filter keywordsexport HN_MIN_SCORE="50"                                         # Minimum story scoreexport HN_EXPERTS="tptacek,simonw,antirez,ept,jepsen"           # Seed experts for trustexport HN_TIME_HOURS="24"                                        # Time window

How It Works

When you ask HN questions, your AI agent uses these tools:

  • discover_stories() — Top stories filtered by keywords/score/time, ranked by quality signals
  • search() — Algolia search with explainable ranking
  • find_experts() — Find domain experts using EigenTrust on comment graph
  • expert_brief() — User profile + activity + trust score
  • story_brief() — Story + top comments + signals in one call
  • thread_analysis() — Full comment tree with quality signals per comment

Every response includes signals breakdown: why each result was chosen.

License

MIT

来源：README.md，提交 eb09fb5

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分