MCP Claude Hackernews

🚀 MCP Claude と Hacker News の統合ガイド

本ガイドでは、MCP（Model Context Protocol）Claude で Hacker News のデータを統合して使用する方法を詳しく説明します。このガイドを通じて、Claude Desktop から Hacker News プラットフォーム上の最新の記事、人気コンテンツ、コメントにアクセス、クエリ、分析することができるようになります。

🚀 クイックスタート

このガイドを使えば、MCP Claude で Hacker News のデータを簡単に統合して活用できます。以下の手順に従って、セットアップと使用を行いましょう。

📦 インストール

1. MCP ライブラリのダウンロード

ターミナルで以下のコマンドを実行して、MCP ライブラリをダウンロードしてインストールします。

npm install mcp-claudie

2. 依存関係のインストール

Node.js と npm がインストールされていることを確認してから、以下のコマンドを実行して必要な依存関係をインストールします。

npm install hacker-news-api

3. MCP プロジェクトの初期化

プロジェクトディレクトリに mcp-config.json ファイルを作成し、以下の内容を追加します。

{
  "services": {
    "hacker-news": {
      "type": "api",
      "endpoint": "https://hn.algolia.com/api/v1"
    }
  },
  "scripts": {
    "start": "node index.js"
  }
}

4. 起動スクリプトの作成

使用しているオペレーティングシステムに応じて、起動スクリプトを作成します。

Windows:

C:\Users\%username%\AppData\Roaming\Microsoft\Windows\Start Menu に新しいショートカットを作成します。ターゲットの場所を以下のように設定します。

node.exe C:\path\to\your\project\index.js

macOS/Linux:

/usr/local/bin ディレクトリに mcp-hackernews という名前の実行可能ファイルを作成し、以下の内容を追加します。

#!/bin/bash
cd /path/to/your/project && node index.js

ファイルに実行権限を付与します。

chmod +x /usr/local/bin/mcp-hackernews

📚 ドキュメント

設定ガイド

1. 設定ファイルの作成

プロジェクトのルートディレクトリに config.json ファイルを作成し、以下の内容を追加します。

{
  "api_key": "your_hacker_news_api_key",
  "max_results": 50,
  "default_category": "programming"
}

2. 設定ファイルの変更

必要に応じて設定ファイルを変更します。たとえば、1 回のクエリで取得する最大結果数を制限する場合は、max_results の値を調整します。

使用ガイド

1. MCP サービスの起動

ターミナルで以下のコマンドを実行して、MCP サービスを起動します。

npm start

2. Hacker News データのクエリ

Claude Desktop から以下のコマンドを使って Hacker News データをクエリします。

最新の記事を取得する:

hn latest --50

人気の記事を取得する:

hn top --20

最高の記事を取得する:

hn best --30

特定の記事の詳細情報を取得する:

hn history --12345678

コメントを取得する:

hn comments --3 または hn comments --12345678

3. 自然言語によるクエリ

自然言語で MCP とやり取りすることもできます。たとえば、

• "今日の Hacker News 上の上位 30 の最高の記事を表示"
• "プログラミングカテゴリの最新のニュースをリストアップ"

トラブルシューティング

1. API キーの有効性を確認する

config.json ファイルを確認し、api_key が有効であることを確認します。API キーは Hacker News API ドキュメント から取得できます。

2. ネットワーク接続を確認する

Hacker News サービスに接続できない場合は、デバイスがインターネットに接続されていること、およびファイアウォールが関連するポートをブロックしていないことを確認します。

3. エラーログを確認する

ターミナルで MCP の出力ログを確認して、問題に関する詳細情報を取得します。

npm run debug

貢献ガイド

1. コードの提出

プルリクエストを提出することで、このプロジェクトにコードを貢献することができます。コードがプロジェクトのコーディング規約に準拠していることを確認してください。

2. 機能要求の作成

機能要件や改善提案がある場合は、GitHub リポジトリに新しい問題を作成してください。

📄 ライセンス

このプロジェクトは MIT License に従います。完全なライセンス情報は LICENSE ファイルに記載されています。