MCP Claude Hackernews

🚀 MCP Claude 與 Hacker News 集成指南

本指南詳細介紹瞭如何在 MCP（Model Context Protocol）Claude 中集成和使用來自 Hacker News 的數據。藉助本指南，您能夠從 Claude Desktop 訪問、查詢和分析 Hacker News 平臺上的最新故事、熱門內容及評論。

🚀 快速開始

若要在 MCP Claude 中集成 Hacker News 數據，可按照以下步驟操作：

1. 完成 MCP 庫的下載與安裝。
2. 安裝必要的依賴項。
3. 初始化 MCP 項目。
4. 創建啟動腳本。
5. 進行配置文件的創建與修改。
6. 啟動 MCP 服務並查詢 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. 修改配置文件

可根據需求修改配置文件。例如，若要限制每次查詢的最大結果數，可調整 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 有效。您可在 Hacker News API 文檔 中獲取 API 密鑰。

2. 檢查網絡連接

若無法連接到 Hacker News 服務，請確保設備已連接互聯網，且防火牆未阻止相關端口。

3. 查看錯誤日誌

在終端查看 MCP 的輸出日誌，以獲取更多問題詳細信息：

npm run debug

貢獻指南

1. 提交代碼

您可通過提交拉取請求為本項目貢獻代碼，請確保代碼符合項目的編碼規範。

2. 創建功能請求

若有功能需求或改進建議，請在 GitHub 倉庫中創建新問題。

📄 許可證

此項目遵循 MIT License，您可在 LICENSE 文件中找到完整的許可信息。