Hn Companion MCP

🚀 Hacker News Companion MCP プロジェクト説明

このプロジェクトは、Claudeを使ってHacker Newsの議論を要約するためのモデルコンテキストプロトコル（MCP）です。

🚀 クイックスタート

このMCPは、Hacker Newsから議論を取得して処理し、Claudeが使用できる形式に整形し、質の高い要約を生成します。コメントの階層構造とそのメタデータ（スコア、反対票など）を処理し、Claudeが異なるコメントの相対的な重要性と関係を理解するのを助けます。

✨ 主な機能

• Hacker Newsのリンクまたは投稿IDを処理します。
• Hacker News上のコメント構造をダウンロードして分析します。
• コミュニティの参加度に基づいてコメントを評価します。
• Claudeの要約生成に適した形式でデータを準備します。

📦 インストール

Smitheryを通じたインストール

Smitheryを通じてClaudeデスクトップ版のHacker News Companionを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @georgeck/hn-companion-mcp --client claude

手動インストール

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

   git clone https://github.com/yourusername/hn-companion-mcp.git
   cd hn-companion-mcp
   

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

   npm install
   

💻 使用例

CLIコマンドライン

node index.js <post-id-or-url>

例：

node index.js 43448075
# または
node index.js https://news.ycombinator.com/item?id=43448075

APIサーバー

サーバーを起動します。

npm start

リクエストを送信します。

curl -X POST http://localhost:3000/api/summarize \
  -H "Content-Type: application/json" \
  -d '{"input": "https://news.ycombinator.com/item?id=43448075"}'

📚 ドキュメント

APIリファレンス

POST /api/summarize インターフェース

リクエストボディ：

{
  "input": "https://news.ycombinator.com/item?id=43448075"
}

レスポンス：

{
  "status": "success",
  "data": {
    "systemPrompt": "...",
    "userPrompt": "...",
    "commentPathIdMapping": { ... },
    "postTitle": "...",
    "postId": "...",
    "commentCount": 123
  }
}

Claudeへの統合

このMCPは、Claudeが要約を行うためのデータを準備することを目的としています。ユーザーがClaudeにHacker Newsの議論を要約するように要求すると、ClaudeはこのMCPを呼び出してフォーマットされたデータを取得し、提供されたシステムおよびユーザープロンプトに基づいて要約を生成します。

"hn-companion": {
      "command": "node",
      "args": ["<full path to src>/hn-companion-mcp/server.js"]
    }
  }

📄 ライセンス

MIT