Hn Server

🚀 Hacker News MCP 服務器

Hacker News MCP服務器是一個實用的工具，它能從Hacker News獲取各類故事。通過解析news.ycombinator.com的HTML內容，為熱門、最新、提問、展示、工作等不同類型的故事提供結構化數據，滿足多樣化的信息需求。

✨ 主要特性

• 豐富的故事類型：可獲取熱門、最新、提問、展示、工作等不同類型的故事。
• 結構化數據輸出：能獲得包含標題、URL、點數、作者、時間戳和評論數量等的結構化數據。
• 可配置的數量限制：支持配置返回故事的數量，靈活滿足需求。
• 清晰的錯誤處理：具備清晰的錯誤處理和驗證機制，確保使用穩定。

📦 安裝指南

1. 克隆倉庫：

git clone https://github.com/pskill9/hn-server
cd hn-server

2. 安裝依賴項：

npm install

3. 構建服務器：

npm run build

4. 添加到MCP設置配置文件：具體位置取決於系統。

對於VSCode Claude擴展：

{
  "mcpServers": {
    "hacker-news": {
      "command": "node",
      "args": ["/path/to/hn-server/build/index.js"]
    }
  }
}

💻 使用示例

基礎用法

該服務器提供了一個名為 get_stories 的工具，用於從Hacker News獲取故事。

工具：get_stories

參數：

• type (字符串)：要獲取的故事類型
  • 可選值：'top', 'new', 'ask', 'show', 'jobs'
  • 默認值：'top'
• limit (數字)：要返回的故事數量
  • 範圍：1-30
  • 默認值：10

示例用法：

use_mcp_tool with:
server_name: "hacker-news"
tool_name: "get_stories"
arguments: {
  "type": "top",
  "limit": 5
}

樣本輸出：

[
  {
    "title": "示例故事標題",
    "url": "https://example.com/story",
    "points": 100,
    "author": "用戶名",
    "time": "2024-12-28T00:03:05",
    "commentCount": 50,
    "rank": 1
  },
  // ... 更多故事
]

📚 詳細文檔

集成到Claude

要與Claude一起使用此MCP服務器，您需要：

1. 安裝Claude桌面應用或VSCode Claude擴展。
2. 在設置中配置MCP服務器。
3. 使用Claude的自然語言接口來交互Hacker News。

配置

對於Claude桌面應用：

{
  "mcpServers": {
    "hacker-news": {
      "command": "node",
      "args": ["/path/to/hn-server/build/index.js"]
    }
  }
}

錯誤處理

該服務器包含穩健的錯誤處理，包括：

• 無效的故事類型
• 網絡故障
• HTML解析錯誤
• 無效參數值

錯誤會以適當的錯誤代碼和描述消息返回。

📄 許可證

本項目採用MIT License，歡迎在您的項目中自由使用。

🤝 貢獻

歡迎貢獻！請隨時提交Pull Request。