Hacker News MCP Server

Hacker News MCP Server

site icon
2024.12.31 25
JavaScriptHacker News 数据获取结构化数据解析搜索工具
Hacker News MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,专门用于从 Hacker News 获取结构化数据。它能够解析 news.ycombinator.com 的 HTML 内容,并提供不同类型的故事(如 top、new、ask、show、jobs)的详细信息,包括标题、URL、点赞数、作者、时间戳和评论数等。
View on GitHub

Overview

基本能力

产品定位

Hacker News MCP Server 是一个专门用于从 Hacker News 获取结构化数据的服务,适用于需要集成 Hacker News 内容的开发者和应用。

核心功能

  • 获取不同类型的故事(top、new、ask、show、jobs)
  • 提供结构化数据,包括标题、URL、点赞数、作者、时间戳和评论数
  • 可配置返回的故事数量限制
  • 完善的错误处理和验证机制

适用场景

  • 开发需要集成 Hacker News 内容的应用程序
  • 自动化获取 Hacker News 的最新或热门故事
  • 分析和监控 Hacker News 上的讨论趋势

工具列表

  • get_stories: 用于从 Hacker News 获取故事的工具
  • 参数:
    • type (string): 故事类型('top', 'new', 'ask', 'show', 'jobs')
    • limit (number): 返回的故事数量(1-30)

常见问题解答

  • 如何配置 MCP 服务器?
  • 需要在 Claude 桌面应用或 VSCode Claude 扩展的配置文件中添加服务器配置。
  • 如何与 Claude 集成?
  • 配置完成后,可以通过自然语言指令与 Claude 交互,获取 Hacker News 的故事。

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm
  2. 克隆仓库并安装依赖:
git clone https://github.com/pskill9/hn-server
cd hn-server
npm install

安装教程

  1. 构建服务器:
npm run build
  1. 配置 MCP 服务器:
{
  "mcpServers": {
    "hacker-news": {
      "command": "node",
      "args": ["/path/to/hn-server/build/index.js"]
    }
  }
}

调试方式

  1. 修改 src/index.ts 文件
  2. 重新构建服务器:
npm run build
  1. 测试工具调用:
use_mcp_tool with:
server_name: "hacker-news"
tool_name: "get_stories"
arguments: {
  "type": "top",
  "limit": 5
}

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。