Hn MCP

🚀 Hacker 新聞 MCP 服務器

官方的 Hacker 新聞 MCP 服務器，能為 Cursor、Claude 以及其他任何 LLM 客戶端添加強大的 Hacker 新聞集成功能。藉助 Model Context Protocol，可實現對故事、評論、用戶資料的訪問以及搜索功能。

🚀 快速開始

此 Hacker 新聞 MCP 服務器可按以下方式進行設置：

在 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

✨ 主要特性

• 利用 Algolia 的 HN Search API 搜索故事和評論。
• 依據類型（top、new、best、ask、show、job）獲取多個故事。
• 獲取帶有評論的故事。
• 獲取評論樹和用戶討論內容。
• 獲取用戶資料和提交內容。
• 實現對 Hacker 新聞數據的即時訪問。

📚 詳細文檔

工具

1. search

   • 功能：使用 Algolia 的搜索 API 在 Hacker 新聞上搜索故事和評論。
   • 輸入：
     • query (字符串)：搜索查詢內容。
     • type (可選字符串)：按類型過濾（'story' 或 'comment'）。
     • page (可選數字)：頁碼。
     • hitsPerPage (可選數字)：每頁結果數（最多 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 新聞數據的全面訪問。