Hacker News MCP 服务器

一个提供从Hacker News获取故事工具的模型上下文协议（MCP）服务器。该服务器解析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解析错误
• 无效参数值

错误会以适当的错误代码和描述消息返回。

贡献

欢迎贡献！请随时提交Pull Request。

许可证

MIT License - 欢迎在您的项目中自由使用。