mcp-claude-hackernews

MCP クロード・ハッカーニュース

特徴

• Hacker Newsの最新記事を閲覧する
• トップストーリーと最高評価のストーリーを見る
• ストーリーの詳細を見る
• 記事のコメントを読む
• Hacker News のコンテンツを整理して読みやすくする

デモ

要件

• Node.js 16以上
• クロードデスクトップ
• Hacker News APIにアクセスするためのインターネット接続

インストール

手動でインストールする

1. このリポジトリをクローンまたはダウンロードします:

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

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

MCPサーバーの実行

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

オプション1: 手動で実行する

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

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の設定を追加します。ファイルが存在しない場合は作成してください。

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

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

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

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

使用法

1. 設定を変更した後、Claude Desktopを再起動します。
2. Claudeでは、 hnコマンドを使用してHacker Newsとやり取りします。
3. MCPサーバーはClaude Desktopによって管理される子プロセスとして実行されます。

利用可能なコマンド

Hacker News MCP は、 hnという単一のツールといくつかのコマンドを提供します。

使用例

以下に、クロード氏による Hacker News MCP の使用方法に関するさまざまな例を示します。

直接コマンド:

自然言語クエリ:

自然言語を使ってMCPと対話することもできます。クロードはこれらのリクエストを解釈し、適切なコマンドを使用します。

• 「今日のHacker Newsのトップ30記事を見せてください」
• 「Hacker News の最新 40 件の投稿は何ですか?」
• 「Hacker Newsのベスト記事20を見たい」
• 「Hacker News から最近の技術ニュース記事を 30 件取得してもらえますか?」
• 「Hacker Newsで話題のトップ50を教えてください」
• 「機械学習に関する Hacker News の記事を 20 件表示してください」
• 「最新の Hacker News の見出しを 40 件表示してください」
• 「現在 Hacker News で最も活発な 30 の議論は何ですか?」
• 「今週最も人気のあるHacker Newsの記事40件を読みたい」
• 「Hacker Newsのプログラミング記事ベスト20のリストを見せてください」

言語翻訳リクエスト:

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

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

トラブルシューティング

「サーバーが切断されました」エラー

Claude Desktop で「MCP Hacker News: サーバーが切断されました」というエラーが表示された場合:

1. サーバーが実行中であることを確認します:
   • ターミナルを開き、プロジェクトディレクトリからnode build/index.js手動で実行します。
   • サーバーが正常に起動したら、このターミナルを開いたままClaudeを使用します。
2. 設定を確認してください:
   • claude_desktop_config.jsonの絶対パスがシステムに合っていることを確認してください
   • Windowsのパスに二重のバックスラッシュ（ \\ ）を使用していることを確認してください
   • ファイルシステムのルートからの完全なパスを使用していることを確認してください
3. 自動起動オプションを試してください:
   • 「自動起動スクリプトの設定」セクションの説明に従って、オペレーティング システムの自動起動スクリプトを設定します。
   • これにより、必要なときにサーバーが常に実行されるようになります。

クロードにツールが表示されない

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

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

サーバーが実行中かどうかを確認しています

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

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

サーバーが実行中になっていない場合は、手動で起動するか、自動起動の方法を使用します。

貢献

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

ライセンス

このプロジェクトは、Mozilla Public License 2.0 に基づいてライセンスされています。詳細については、 LICENSEファイルを参照してください。

関連リンク

• モデルコンテキストプロトコル
• ハッカーニュースAPI
• クロードデスクトップ