Hacker News Trending — hosted on Cloudflare Workers (HTTP + npm stdio)

Hacker News Trending MCP — フロントページのストーリー、Algolia の全文検索、Show HN のローンチ追跡

HN のフロントページ、Algolia の全文検索、Show HN のローンチ追跡、アイテムとユーザーの検索

Hacker News 用のホスト型 MCP サーバーです。現在のフロントページ／人気記事／新着記事／Ask HN／Show HN／求人記事を取得し、ポイント数や経過日数でフィルターしながら、ストーリーとコメントを対象に Algolia の全文検索を実行できます。最近の Show HN ローンチを追跡したり、個別のアイテムやユーザープロフィールを取得したりすることもできます。技術トレンド、インディーローンチ、Show HN の追跡に対応する LLM 向けです。

このサーバーは Model Context Protocol に対応しています。Cursor、Claude Desktop、Windsurf、Continue.dev、または @modelcontextprotocol/sdk を使って独自に作成したエージェントなど、MCP 対応のクライアントから接続して、ツールを検出し、Bearer トークン認証で呼び出せます。

AI エージェント／LLM 向け

このリポジトリをインデックス化する AI エージェント向けの情報です。

• ライブ MCP エンドポイント： https://hn-trending-mcp.atlasword.workers.dev/mcp
• トランスポート： HTTP POST、JSON-RPC 2.0
• 認証： Authorization: Bearer <api_key>（無料枠では匿名で月100回まで、IPごとに利用可能）
• 検出： tools/list で完全なスキーマを返します。tools/call でツールを呼び出します。
• ヘルスチェック： GET https://hn-trending-mcp.atlasword.workers.dev/health → {ok: true, ts: <unix>}
• ステータス： https://mcp-hub.atlasword.workers.dev/status.json（ポートフォリオ全体の集計）

tools/list のリクエスト例：

curl -sS -X POST https://hn-trending-mcp.atlasword.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mck_YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

tools/call の例：

curl -sS -X POST https://hn-trending-mcp.atlasword.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mck_YOUR_API_KEY" \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params": { "name": "<tool>", "arguments": { } }
  }'

提供されるツール

ツール	引数	説明
hn_top	kind?, limit?	HN のフロントページのストーリー — kind=top
hn_search	query, tags?, min_points?, days_ago?	Algolia を使ってストーリーとコメントを全文検索します。
hn_show_recent	min_points?, days?	直近K日間にNポイント以上を獲得した、最近の Show HN ローンチ。
hn_item	id	id で指定した単一の HN アイテム（ストーリーまたはコメント）を取得します。
hn_user	username	HN ユーザープロフィール：カルマ、アカウント作成からの経過期間、最近の投稿。

Team+ と記されたツールには、Team または Pro のサブスクリプションが必要です。匿名ユーザーと Free プランの利用者がこれらを呼び出すと、tier_required エラーが返されます。

クイックスタート

最も手早く使う方法は、mcp-remote を使って、MCP 対応クライアントからホスト型エンドポイントを指定することです。

npx -y mcp-remote https://hn-trending-mcp.atlasword.workers.dev/mcp \
  --header "Authorization: Bearer mck_YOUR_API_KEY"

キーは https://hn-trending-mcp.atlasword.workers.dev/upgrade?tier=solo で取得してください（API キーの取得を参照）。

Cursor へのインストール

~/.cursor/mcp.json に以下を追加します。

{
  "mcpServers": {
    "hn-trending-mcp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://hn-trending-mcp.atlasword.workers.dev/mcp",
        "--header", "Authorization: Bearer mck_YOUR_API_KEY"
      ]
    }
  }
}

その後、Cursor を再起動すると、MCP パネルにツールが表示されます。

Claude Desktop へのインストール

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に以下を追加します。

{
  "mcpServers": {
    "hn-trending-mcp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://hn-trending-mcp.atlasword.workers.dev/mcp",
        "--header", "Authorization: Bearer mck_YOUR_API_KEY"
      ]
    }
  }
}

Claude Desktop を再起動してください。スラッシュコマンドの MCP メニューにツールが表示されます。

API キーの取得方法

1. https://hn-trending-mcp.atlasword.workers.dev/upgrade?tier=solo（または tier=team／tier=pro）にアクセスします。
2. Dodo Payments のホスト型チェックアウトにリダイレクトされます。Dodo が住所を収集し、カード決済を処理し、VAT/GST に対応します。
3. 決済後、Dodo は署名付き Webhook（subscription.active）を Worker に送信します。Worker は mck_<32 random base64url> を生成し、KV に保存します。
4. https://hn-trending-mcp.atlasword.workers.dev/welcome?key=<api_key> に移動します。この URL ではキーが一度だけ表示されるため、ここでコピーしてください。
5. キーを Cursor／Claude Desktop の設定に貼り付けます（上記を参照）。
6. https://hn-trending-mcp.atlasword.workers.dev/account からアカウントの表示／キーのローテーション／エクスポートができます（Bearer 認証）。

無料プランもあり、登録は不要です。匿名の呼び出し元は、IP ごとに月 100 回まで利用できます。

エンドポイント

ルート	説明
POST /mcp	MCP JSON-RPC 2.0 ツールのエンドポイント（メイン API）です。有料プランでは Bearer 認証が必要です。
GET /health	生存確認用エンドポイント — {ok: true, ts}。mcp-hub cron で使用されます。
GET /	HTML ランディングページ（OG + favicon + JSON-LD）。
`GET /upgrade?tier=solo	team
GET /welcome?key=...	チェックアウト後に表示されるランディングページ。新しく生成された API キーが表示されます。
GET /account	Bearer 認証。{apiKey, tier, owner, status, portal_url} を返します。
POST /account/rotate	Bearer 認証。新しいキーを生成し、古いキーを無効にします。
GET /account/export	Bearer 認証。GDPR データエクスポート — アカウント、使用状況カウンター、Dodo の詳細を含む JSON。
GET /account/team	Bearer 認証（Team 以上）。チームメンバーのサブキーを一覧表示します。
POST /account/team/invite	Bearer 認証（Team 以上）。チームメンバー用のサブキーを新規発行します。
POST /account/team/revoke	Bearer 認証（Team 以上）。チームメンバーのサブキーを無効にします。
GET /team/accept?key=...	サブキーの URL 用チームメンバー登録ランディングページ。
POST /webhooks/dodo	Standard-Webhooks 署名付き。Dodo のサブスクリプションおよび決済のライフサイクル。
GET /favicon.ico	インライン SVG。

料金

すべてのプランで月間上限とレート上限は共通で、料金は製品ごとの位置付けを反映しています。

プラン	月間呼び出し回数	レート制限	チーム席数
Free	月 100 回	分あたり 10 回	0
Solo	月 2,000 回	分あたり 60 回	0
Team	月 10,000 回	分あたり 200 回	5
Pro	月 50,000 回	分あたり 600 回	25

プラン	料金	月間呼び出し回数	チーム席数
Free	$0	100	0
Solo	$9/mo	2,000	0
Team	$29/mo	10,000	5
Pro	$79/mo	50,000	25

Dodo Payments 経由で請求されます（販売者登録事業者 — VAT/GST は Dodo が処理します）。いつでも解約でき、アクセスは支払い済み期間の終了まで有効です。

データソース

• Hacker News API (Firebase) — https://github.com/HackerNews/API — 公開 API
• HN Algolia Search — https://hn.algolia.com/api — 無料の公開 API

このサーバーは、上流のデータソースを利用する薄いトランスポート、認証、キャッシュのレイヤーです。呼び出しごとのレート制限は、各上流サービスの無料プランの利用規約を十分に順守できるよう調整されています。

プライバシー + GDPR

• プライバシーポリシー： https://mcp-hub.atlasword.workers.dev/privacy
• 利用規約： https://mcp-hub.atlasword.workers.dev/terms
• 返金ポリシー： https://mcp-hub.atlasword.workers.dev/refund
• データエクスポート： GET https://hn-trending-mcp.atlasword.workers.dev/account/export（Bearer 認証）を実行すると、アカウント、使用状況カウンター、Dodo の顧客情報を含む、機械可読な JSON スナップショットが返されます。
• 削除： 登録済みのメールアドレスから [email protected] にメールを送信してください。

保存するのは、メールアドレス、生成された API キー、月間呼び出しカウンター、Dodo のサブスクリプションメタデータのみです。短いキャッシュ TTL を超えて、ツールの引数や上流の応答をログに記録することはありません。

アーキテクチャ

• ランタイム： Cloudflare Workers（V8 分離環境、グローバルエッジ）。
• ストレージ： 2 つの Cloudflare KV 名前空間 — <slug>-cache（上流レスポンスキャッシュ）と <slug>-usage（API キー、月次カウンター、チーム名簿）。
• 課金： Dodo Payments の本番モード、3 つのサブスクリプション商品（Solo／Team／Pro）、Standard-Webhooks による署名付きライフサイクル。
• オブザーバビリティ： Cloudflare Workers Analytics、ポートフォリオの集計情報は mcp-hub のステータスで確認できます。
• ソース： TypeScript、Vitest でテスト済み、wrangler deploy でデプロイできます。このリポジトリの src/ を参照してください。

ライセンス

MIT — LICENSE を参照してください。

作者

Prakhar Gupta

• メール：[email protected]
• GitHub：@guptaprakhariitr

ステータス

• 稼働状況ページ： https://mcp-hub.atlasword.workers.dev/status
• 機械可読なステータス： https://mcp-hub.atlasword.workers.dev/status.json
• ソースリポジトリ： https://github.com/guptaprakhariitr/hn-trending-mcp

npm でインストール（一行で実行）

薄いランチャーが、npm で @insnapsprakhar/hn-trending-mcp として公開されています。URL を手動でコピー＆ペーストする必要はありません。

npx -y @insnapsprakhar/hn-trending-mcp

または、MCP クライアントに設定できます。

{
  "mcpServers": {
    "hn-trending": {
      "command": "npx",
      "args": ["-y", "@insnapsprakhar/hn-trending-mcp"]
    }
  }
}

npm パッケージはランチャーにすぎません。mcp-remote を起動し、ホストされたエンドポイント（https://hn-trending-mcp.atlasword.workers.dev/mcp）を指定します。