Hacker News MCP — by NeCL – Neural Engineering & Cognitive Logic

necl-hn-mcp

AI エージェント向け Hacker News ツール。 トップ記事、記事の詳細、コメントスレッド、全文検索に対応しています。

認証情報は不要です。 公開 HN API を使用します。インストールしてすぐ使えます。

NeCL が開発 — AI エンジニアリングスタジオです。本番環境で実証済みです。このツールは、社内のコンテンツエージェントを支える HN 層そのもので、数カ月にわたり1日3回稼働しています。

ツール

ツール	機能
hn_top_stories(limit, hours)	過去 N 時間のトップ N 記事をスコア順に取得します。デフォルトは過去24時間のトップ10です。
hn_get_story(id)	記事のメタデータをすべて取得します：タイトル、URL、スコア、投稿者、コメント数、投稿時刻。
hn_get_comments(id, limit)	記事のトップレベルのコメントスレッドを、HN のランキング順に取得します。
hn_search(query, sort)	HN の投稿とコメントを全文検索します（Algolia HN API 経由）。
hn_category(category, limit)	特定のカテゴリーの記事を取得します：top、new、best、ask、show、job。

この MCP を選ぶ理由

• 認証情報も設定も不要 — 公開 HN API を使用します。気にするほどのレート制限はなく、登録も不要です。
• 実運用で鍛えられたコード — 数カ月にわたり1日3回稼働している、社内の HN 記事から下書きを生成するコンテンツエンジンから抽出しました。
• AI エージェント向けに設計 — 各ツールは、LLM が連携して使える、整理された構造化データを返します（検索 → トップ記事 → コメント → 要約）。
• ユースケース — コンテンツ調査、トレンド監視、自動ニュースダイジェスト、プロンプトコンテキストの充実。

インストール

uvx 経由（推奨 — セットアップ不要）

uvx は一時的な環境でパッケージを実行します。pip install も仮想環境も不要です。mcp.json（Claude Desktop、Claude Code、または任意の MCP クライアント）に追加してください：

{
  "mcpServers": {
    "necl-hn": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/adjacentai/necl-hn-mcp.git",
        "necl-hn-mcp"
      ]
    }
  }
}

uvx がインストールされていませんか？pip install uv または brew install uv でインストールできます。

pip + python -m 経由

pip install git+https://github.com/adjacentai/necl-hn-mcp.git

次に、mcp.json に追加します：

{
  "mcpServers": {
    "necl-hn": {
      "command": "python",
      "args": ["-m", "necl_hn_mcp"]
    }
  }
}

ソースから（開発用）

git clone https://github.com/adjacentai/necl-hn-mcp.git
cd necl-hn-mcp
pip install -e ".[dev]"

その後、上記と同じ python -m necl_hn_mcp の設定を使用します。

Claude での使用例

インストールしたら、Claude に次のように尋ねるだけです：

• 「過去6時間の HN のトップ5記事は何ですか？」
• 「HN 記事 38420000 のコメントスレッドを取得して」
• 「RAG のパフォーマンスに関する HN の投稿を、日付順で検索して」
• 「今の Ask HN カテゴリーの記事をすべて見せて」
• 「今週の AI エージェントに関する Show HN のトップ3投稿を探して」

Claude が適切なツールを呼び出すので、追加のセットアップは不要です。

このツールで構築できるもの

• 日次コンテンツブリーフ — HN のトップ記事を取得、要約し、複数プラットフォーム向けの投稿を生成します。
• 競合調査ボット — HN で競合他社への言及を検索し、否定的なコメントを見つけます。
• トレンド検知ツール — cron で new と best カテゴリーを監視し、トピックが急増したときに通知します。
• ニュースレターパイプライン — キーワードと期間を指定して検索し、結果をクラスタリングして、編集済みダイジェストを生成します。
• 顧客発見エージェント — Ask HN で自社製品が解決できる課題を検索し、コールドアウトリーチの下書きを生成します。
• テックレーダー更新ツール — show カテゴリーを定期的にスキャンし、技術スタックに加わる新しいツールを見つけます。

トラブルシューティング

"mcp command not found"／インストールエラー。 Python 3.10 以降を使用していることを確認してください。uvx を使用する場合は、uv がインストールされていることを確認してください（pip install uv）。pip でインストールする場合は、pip install necl-hn-mcp を実行し、python -m necl_hn_mcp --help でエラーが発生しないことを確認してください。

ツール呼び出しがタイムアウトする。 HN の Firebase API は、多数の項目を取得する際に時間がかかることがあります（例：hn_top_stories(limit=30, hours=168) は 200 件のストーリーをスキャンします）。リクエストごとのデフォルトのタイムアウトは 10 秒です。長期間を対象にするクエリでは、limit を小さくしてください。

Algolia で検索結果が返されない。 Algolia の HN コンテンツのインデックス作成には遅延があります（新しい項目では約 5～15 分）。最近の動向を確認するには、sort="date" をお試しください。

HN では確認できるストーリーのコメントスレッドが空です。 hn_get_comments が返すのはトップレベルのコメントのみです。LLM のトークンコストを予測可能に保つため、返信を再帰的に取得することはありません。さらに議論が続いているかどうかは、各コメントの replies_count フィールドで確認できます。

Claude にツールが表示されない。 mcp.json を編集した後は、Claude Desktop／Claude Code を完全に再起動してください（再読み込みだけでは不十分です）。Settings → Developer で MCP のログを確認してください。

組み合わせて使う

• necl-content-poster Skill — HN のストーリーを、TG／LinkedIn／Threads 向けの公開準備が整った投稿に変換します。

完全なパイプライン：

necl-hn-mcp (find story) → necl-content-poster (write 3 posts) → you publish

NeCL が開発

neclco.com — 本番環境向けの AI エンジニアリング。RAG システム、音声エージェント、Telegram ボット、カスタム MCP、コンテンツエンジンを、単なるラッパーでは足りない企業向けに提供します。

社内 API／データベース／SaaS と連携するカスタム MCP が必要ですか？ neclco.com をご覧ください。

開発

git clone https://github.com/adjacentai/necl-hn-mcp.git
cd necl-hn-mcp
pip install -e ".[dev]"

# Run locally with MCP inspector
mcp dev src/necl_hn_mcp/server.py

ライセンス

MIT — LICENSE をご覧ください。

---

NeCL をフォロー：Telegram · LinkedIn · X · サイト