MCP Claude Hacker News

MCP Claude Hacker News

Claude Desktop が Model Context Protocol（MCP）を使用して Hacker News とやり取りできるようにする統合機能です。

機能

• Hacker News の最新記事を閲覧
• 人気記事や高評価の記事を表示
• キーワード、関連度、または新着順で記事を検索（Algolia HN Search API）
• 記事の詳細を取得
• 記事のコメントを閲覧。活発なスレッドでコンテキストがあふれないよう、件数を制限します
• HTML エンティティのデコードを含む、読みやすさを高める Hacker News コンテンツの整形

デモ

要件

• Node.js 20 以降
• Claude Desktop
• Hacker News API にアクセスするためのインターネット接続

インストール

Smithery 経由でのインストール

Smithery サーバーページからパッケージ化されたバンドルをインストールするか、CLI からインストールします。

npx -y @smithery/cli@latest mcp add imprvhub/mcp-claude-hackernews --client claude

手動でのインストール

1. このリポジトリをクローンするか、ダウンロードします。

git clone https://github.com/imprvhub/mcp-claude-hackernews
cd mcp-claude-hackernews

2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

MCP サーバーの実行

MCP サーバーを実行する方法は 2 つあります。

オプション 1：手動で実行

1. ターミナルまたはコマンドプロンプトを開きます
2. プロジェクトディレクトリに移動します
3. サーバーを直接実行します。

node build/index.js

Claude Desktop の使用中は、このターミナルウィンドウを開いたままにしてください。ターミナルを閉じるまでサーバーは実行されます。

オプション 2：Claude Desktop で自動起動（通常の使用におすすめ）

Claude Desktop は、必要に応じて MCP サーバーを自動的に起動できます。設定方法は次のとおりです。

設定

Claude Desktop の設定ファイルは次の場所にあります。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

このファイルを編集して、Hacker News MCP の設定を追加します。ファイルが存在しない場合は作成してください。

{
  "mcpServers": {
    "hackerNews": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_DIRECTORY/mcp-claude-hackernews/build/index.js"]
    }
  }
}

重要：ABSOLUTE_PATH_TO_DIRECTORY を MCP をインストールした場所の完全な絶対パスに置き換えてください。

• macOS/Linux の例：/Users/username/mcp-claude-hackernews
• Windows の例：C:\\Users\\username\\mcp-claude-hackernews

すでにほかの MCP を設定している場合は、「mcpServers」オブジェクト内に「hackerNews」セクションを追加するだけです。複数の MCP を設定した例を次に示します。

{
  "mcpServers": {
    "otherMcp1": {
      "command": "...",
      "args": ["..."]
    },
    "otherMcp2": {
      "command": "...",
      "args": ["..."]
    },
    "hackerNews": {
      "command": "node",
      "args": [
        "ABSOLUTE_PATH_TO_DIRECTORY/mcp-claude-hackernews/build/index.js"
      ]
    }
  }
}

claude_desktop_config.json ファイルの設定に基づき、Claude Desktop が必要に応じて MCP サーバーを自動的に起動します。

使用方法

1. 設定を変更した後、Claude Desktop を再起動します
2. Claude で Hacker News ツールを使用して Hacker News とやり取りします
3. MCP サーバーは Claude Desktop が管理する子プロセスとして実行されます

利用可能なツール

Hacker News MCP には、さまざまな機能に対応する6 つの専用ツールがあります。

ツール	説明	パラメーター	使用例
hn_latest	Hacker News の最新記事を取得します	limit：記事数（省略可、1～50、デフォルト：10）	最新記事を20件取得する
hn_top	Hacker News のランキング上位の記事を取得します	limit：記事数（省略可、1～50、デフォルト：10）	上位記事を15件取得する
hn_best	Hacker News のベスト記事を取得します	limit：記事数（省略可、1～50、デフォルト：10）	ベスト記事を25件取得する
hn_search	キーワードで記事を検索します	query：必須の検索語句、limit：1～50（デフォルト：10）、sort：relevance（デフォルト）またはdate	「rust async」を日付順で検索する
hn_story	特定の記事の詳細情報を取得します	story_id：必須の記事 ID（数値）	ID で記事の詳細を取得する
hn_comments	記事のトップレベルのコメントを取得します	story_id：記事 ID（数値）、またはstory_index：直近のリストでの記事のインデックス（1 始まり）、limit：1～50（デフォルト：20）	記事 ID またはインデックスでコメントを取得する

ツールパラメーターの詳細

hn_latest、hn_top、hn_best

• limit（省略可）：取得する記事数
  • 型：数値
  • 範囲：1～50
  • デフォルト：10

hn_search

• query（必須）：検索語句
  • 型：文字列
  • 例："model context protocol"
• limit（省略可）：検索結果数。1～50、デフォルトは10
• sort（省略可）：relevance（デフォルト）または最新順のdate

hn_story

• story_id（必須）：取得する記事の ID
  • 型：数値
  • 例：12345678

hn_comments

• story_id（省略可）：コメントを取得する記事の ID
  • 型：数値
  • 例：12345678
• story_index（省略可）：直近に取得したリスト内の記事のインデックス
  • 型：数値（1 始まり）
  • 例：3（直近のリストの3番目の記事）
• limit（省略可）：返すトップレベルコメントの最大数
  • 型：数値
  • 範囲：1～50
  • デフォルト：20

注：hn_commentsでは、story_idまたはstory_indexのいずれかを指定する必要があります。取得されるのはトップレベルのコメントのみで、返信数はコメントごとに表示されます。スレッドのトップレベルコメントのうち、いくつ返されたかはレスポンスに記載されます。

使用例

Claude で Hacker News MCP を使用するさまざまな例を紹介します。

ツールを直接使用する場合：

"Use hn_latest to get 20 recent stories"
"Use hn_top with limit 15 to get top stories"
"Use hn_best to get 25 best stories"
"Use hn_search with query 'model context protocol' to find related stories"
"Use hn_search with query 'rust' and sort date to see the newest posts"
"Use hn_story with story_id 29384756 to get story details"
"Use hn_comments with story_index 3 to get comments for the 3rd story"
"Use hn_comments with story_id 12345678 to get comments for that story"

自然言語での問い合わせ：

自然言語を使って MCP とやり取りすることもできます。Claude がリクエストを解釈し、適切なツールを使用します。

• 「今日の Hacker News のトップ記事を30件表示して」
• 「Hacker News の最新投稿を40件教えて」
• 「Hacker News のベスト記事を20件見たい」
• 「Hacker News から最近のテクノロジーニュースを30件取得して」
• 「Hacker News で話題のトピック上位50件を教えて」
• 「Hacker News で機械学習に関する記事を検索して」
• 「Hacker News の最新見出しを40件取得して」
• 「今、Hacker News で最も活発な議論を30件教えて」
• 「今週、Hacker News で最も人気のある記事を40件読みたい」
• 「Hacker News の優れたプログラミング記事を20件リスト表示して」
• 「直近のリストにある5番目の記事のコメントを取得して」
• 「記事 ID 12345678 の詳細を表示して」

言語翻訳のリクエスト：

Hacker News のコンテンツを別の言語に翻訳するようリクエストできます。

• 「今日の Hacker News のトップ記事を30件、スペイン語で表示して」
• 「Hacker News の最新投稿を20件取得して、フランス語に翻訳して」
• 「Hacker News のベスト記事を40件、ドイツ語で見たい」
• 「最近の Hacker News の記事を30件、日本語に翻訳して表示して」
• 「Hacker News のトップ記事を20件取得して、ポルトガル語で表示して」

トラブルシューティング

「Server disconnected」エラー

Claude Desktop で「MCP Hacker News: Server disconnected」というエラーが表示される場合：

1. サーバーが実行中であることを確認する：

   • ターミナルを開き、プロジェクトディレクトリから node build/index.js を手動で実行します
   • サーバーが正常に起動した場合は、ターミナルを開いたまま Claude を使用します

2. 設定を確認する：

   • claude_desktop_config.json の絶対パスが、お使いのシステムで正しいことを確認します
   • Windows のパスには、バックスラッシュを 2 つ（\\）使用していることを再確認します
   • ファイルシステムのルートからの完全なパスを使用していることを確認します

3. 自動起動オプションを試す：

   • 「自動起動スクリプトの設定」セクションの説明に従って、お使いのオペレーティングシステム用の自動起動スクリプトを設定します
   • これにより、必要なときに常にサーバーが実行されるようになります

Claude にツールが表示されない

Hacker News のツールが Claude に表示されない場合：

• 設定後に Claude Desktop を再起動したことを確認します
• Claude Desktop のログで MCP 通信エラーがないか確認します
• MCP サーバープロセスが実行中であることを確認します（手動で実行して確認してください）
• MCP サーバーが Claude Desktop の MCP レジストリに正しく登録されていることを確認します

サーバーが実行中かどうかを確認する

サーバーが実行中かどうかを確認するには：

• Windows：タスク マネージャーを開き、「詳細」タブに移動して、「node.exe」を探します
• macOS/Linux：ターミナルを開き、ps aux | grep node を実行します

サーバーが実行中でない場合は、手動で起動するか、自動起動方式を使用してください。

開発

テストスイートを実行します（ネットワークは不要です）：

npm install
npm run build
npm test

貢献

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

ライセンス

このプロジェクトは Mozilla Public License 2.0 のもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。

関連リンク

• Model Context Protocol
• Hacker News API
• Claude Desktop
• MCP Series