remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

ハッカーニュースMCPサーバー

Hacker Newsから記事を取得するためのツールを提供するModel Context Protocol（MCP）サーバー。このサーバーはnews.ycombinator.comのHTMLコンテンツを解析し、様々なタイプの記事（トップ、新着、質問、ショー、求人）の構造化データを提供します。

特徴

さまざまな種類のストーリー（トップ、新着、質問、表示、求人）を取得します
タイトル、URL、ポイント、著者、タイムスタンプ、コメント数などの構造化データを取得します
返されるストーリーの数の設定可能な制限
クリーンなエラー処理と検証

インストール

リポジトリをクローンします。

git clone https://github.com/pskill9/hn-server
cd hn-server

依存関係をインストールします:

npm install

サーバーを構築します。

npm run build

MCP 設定構成ファイルに追加します (場所はシステムによって異なります)。

VSCode Claude 拡張機能の場合:

{
  "mcpServers": {
    "hacker-news": {
      "command": "node",
      "args": ["/path/to/hn-server/build/index.js"]
    }
  }
}

使用法

サーバーは、Hacker News から記事を取得するために使用できるget_storiesと呼ばれるツールを提供します。

ツール: get_stories

パラメータ:

type (文字列): 取得するストーリーの種類
- オプション: 「トップ」、「新着」、「質問」、「表示」、「求人」
- デフォルト: 'top'
limit (数値): 返されるストーリーの数
- 範囲: 1～30
- デフォルト: 10

使用例:

use_mcp_tool with:
server_name: "hacker-news"
tool_name: "get_stories"
arguments: {
  "type": "top",
  "limit": 5
}

サンプル出力:

[
  {
    "title": "Example Story Title",
    "url": "https://example.com/story",
    "points": 100,
    "author": "username",
    "time": "2024-12-28T00:03:05",
    "commentCount": 50,
    "rank": 1
  },
  // ... more stories
]

クロードとの統合

この MCP サーバーを Claude で使用するには、次のことが必要です。

ClaudeデスクトップアプリまたはVSCode Claude拡張機能がインストールされている
設定でMCPサーバーを構成する
Claudeの自然言語インターフェースを使用してHacker Newsと対話する

構成

Claude デスクトップアプリの場合は、次のサーバー構成を追加します。

// ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
// %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
  "mcpServers": {
    "hacker-news": {
      "command": "node",
      "args": ["/path/to/hn-server/build/index.js"]
    }
  }
}

VSCode Claude 拡張機能の場合は、以下を追加します。

// VSCode Settings JSON
{
  "mcpServers": {
    "hacker-news": {
      "command": "node",
      "args": ["/path/to/hn-server/build/index.js"]
    }
  }
}

やり取りの例

設定が完了すると、自然言語を使ってクロードと対話し、Hacker Newsの記事を取得できるようになります。例：

「Hacker Newsのトップ5のニュースを見せてください」
「最新の Ask HN 投稿は何ですか?」
「今日のショーHNのトップ投稿を取得してください」

Claude は適切なパラメータを自動的に使用して、必要なストーリーを取得します。

ストーリーオブジェクト構造

各ストーリーオブジェクトには次のものが含まれます。

title (文字列): ストーリーのタイトル
url (文字列、オプション): ストーリーのURL (テキスト投稿の場合は内部HN URL)
points （数値）：賛成票の数
author (文字列): 投稿者のユーザー名
time (文字列): ストーリーが投稿されたときのタイムスタンプ
commentCount (数値): コメント数
rank （数字）：リスト内の位置

発達

サーバーは以下を使用して構築されます:

タイプスクリプト
モデルコンテキストプロトコルSDK
HTTPリクエスト用のAxios
HTML解析用のCheerio

サーバーを変更するには:

src/index.tsに変更を加える
再構築:

npm run build

エラー処理

サーバーには、次の堅牢なエラー処理機能が含まれています。

無効なストーリータイプ
ネットワーク障害
HTML解析エラー
無効なパラメータ値

エラーは、適切なエラーコードと説明メッセージとともに返されます。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

MIT ライセンス - ご自身のプロジェクトで自由にご利用ください。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

get_stories

news.ycombinator.com (Hacker News) からの HTML コンテンツを解析し、さまざまな種類のストーリー (トップ、新着、質問、表示、求人) の構造化データを提供します。

Related Resources

Reddit Discussion about this server

Hacker News MCP