mcpField
R
readhn

readhn

ローカル
github.com/xodn348ソーシャルメディア533 週間前に更新
リポジトリ

readhn について

readhnは、AIエージェント向けのHackerNews MCPサーバーです。ストーリーや分野の専門家を探し、選定理由を示す品質シグナルで結果を順位付けします。

主な機能

  1. 01キーワード、スコア、期間でストーリーを絞り込み
  2. 02EigenTrustによる分野専門家の検索
  3. 03コメントツリーと品質の分析
  4. 04品質シグナルによる順位の説明

活用シーン

  1. 01今週のRust関連人気記事の発見
  2. 02HNでデータベース専門家を検索
  3. 03Kubernetesネットワークに関する実務家の見解を確認

MCP 対応

ストーリーの発見・検索、専門家の検索、ユーザーとストーリーの概要、スレッド分析ツールをMCPクライアントに提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "xodn348-readhn": {
      "command": "uvx",
      "args": [
        "readhn"
      ]
    }
  }
}
起動コマンドuvx readhn

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypireadhn0.2.0

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

readhn

PyPI Tests Coverage MCP

AI ネイティブな HackerNews MCP サーバー。説明可能な品質シグナルをもとに、重要な HN コンテンツを見つけます。

できること

発見 — キーワード、スコア、時間でストーリーを絞り込みます。品質シグナルに基づいて順位付けされた結果を取得できます。

信頼 — ドメインエキスパートを見つけます。誰が発言しているのか、なぜ重要なのかを確認できます。シードエキスパートから EigenTrust による伝播を行います。

理解 — すべての結果で、その理由を説明します。5 つのシグナル：実務者の深さ（30%）、スレッドの深さ（20%）、エキスパートの関与（20%）、勢い（15%）、参照（15%）。

クイックスタート

# Install
pip install readhn

# Auto-configure supported AI agents
readhn setup

readhn setup は Claude Code、Codex、Cursor、Claude Desktop、Cline、Windsurf、OpenCode の設定パスを検出し、readhn MCP サーバーを追加します。

便利なセットアップ用フラグ：

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

セットアップ後、AI エージェントは readhn を自動検出し、HN に関する質問をすると使用します。

使い方

AI エージェントに次のように尋ねます：

  • 「今週の Rust に関する HN のトップストーリーを見せて」
  • 「HN でデータベースについて書いているエキスパートを見つけて」
  • 「Kubernetes のネットワークについて、実務者は何と言っていた？」

エージェントは readhn ツールを呼び出して品質シグナル付きの結果を取得し、それぞれの結果が重要な理由を説明します。

設定（任意）
export HN_KEYWORDS="ai,llm,rust,distributed-systems,databases"  # Default filter keywords
export HN_MIN_SCORE="50"                                         # Minimum story score
export HN_EXPERTS="tptacek,simonw,antirez,ept,jepsen"           # Seed experts for trust
export HN_TIME_HOURS="24"                                        # Time window

仕組み

HN に関する質問をすると、AI エージェントは次のツールを使用します：

  • discover_stories() — キーワード／スコア／時間で絞り込んだトップストーリーを、品質シグナルに基づいて順位付けします
  • search() — 説明可能な順位付けを備えた Algolia 検索
  • find_experts() — コメントグラフ上で EigenTrust を使ってドメインエキスパートを見つけます
  • expert_brief() — ユーザープロフィール＋活動状況＋信頼スコア
  • story_brief() — ストーリー＋上位コメント＋シグナルを 1 回の呼び出しで取得します
  • thread_analysis() — コメントごとの品質シグナルを含むコメントツリー全体

すべての応答にシグナルの内訳が含まれ、各結果が選ばれた理由を確認できます。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。