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 分