Hn MCP

🚀 Hacker 新闻 MCP 服务器

官方の Hacker 新闻 MCP サーバーです。Cursor、Claude やその他の LLM クライアントに強力な Hacker ニュース統合機能を追加します。Model Context Protocol を通じて、記事、コメント、ユーザープロフィール、検索機能にアクセスできます。

✨ 主な機能

• Algolia の HN Search API を使用して、記事とコメントを検索する
• タイプ（トップ、新着、ベスト、質問、ショーケース、求人）に基づいて複数の記事を取得する
• コメント付きの記事を取得する
• コメントツリーとユーザーの議論を取得する
• ユーザープロフィールと投稿内容を取得する
• Hacker ニュースのデータにリアルタイムでアクセスする

📦 インストール

Claude Desktop での実行

以下の内容を claude_desktop_config.json に追加してください。

{
  "mcpServers": {
    "hackernews": {
      "command": "npx",
      "args": ["-y", "@devabdultech/hn-mcp-server"]
    }
  }
}

Smithery を通じたインストール

Smithery を通じて、Claude Desktop 用に Hacker ニュース MCP サーバーを自動インストールするには、以下のコマンドを実行します。

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

📚 ドキュメント

1. search

• Algolia の検索 API を使用して、Hacker ニュース上で記事とコメントを検索します。
• 入力:
  • query (文字列)：検索クエリ
  • type (オプションの文字列)：タイプでフィルタリング ('story' または 'comment')
  • page (オプションの数値)：ページ番号
  • hitsPerPage (オプションの数値)：1 ページあたりの結果数（最大 100）
• 返り値: 記事とコメントを含む検索結果

2. getStories

• タイプに基づいて複数の記事を取得します。
• 入力:
  • type (文字列)：取得する記事のタイプ ('top', 'new', 'best', 'ask', 'show', 'job')
  • limit (オプションの数値)：取得する記事の数（最大 100）
• 返り値: 記事オブジェクトの配列

3. getStoryWithComments

• 記事とそのコメントスレッドを取得します。
• 入力:
  • id (数値)：記事 ID
• 返り値: ネストされたコメント付きの記事の詳細情報

4. getCommentTree

• 記事の完全なコメントツリーを取得します。
• 入力:
  • storyId (数値)：記事 ID
• 返り値: 階層的なコメントツリー構造

5. getUser

• ユーザーのプロフィール情報を取得します。
• 入力:
  • id (文字列)：ユーザー名
• 返り値: 魅力値、作成日、自己紹介テキストを含むユーザープロフィールの詳細情報

6. getUserSubmissions

• ユーザーの投稿内容（記事とコメント）を取得します。
• 入力:
  • id (文字列)：ユーザー名
• 返り値: ユーザーが投稿した記事とコメントの配列

貢献方法

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更をコミットする
4. ブランチにプッシュする
5. 新しい Pull Request を作成する

📄 ライセンス

この MCP サーバーは MIT ライセンスの下で公開されています。詳細については、LICENSE ファイルを参照してください。

概要

この MCP サーバーは devabdultech によって構築およびメンテナンスされています。公式の Hacker ニュース API と Algolia 検索 API を使用し、Model Context Protocol を通じて Hacker ニュースのデータに全面的にアクセスできます。