使用说明

项目简介

Hacker News MCP服务器是一个基于 Model Context Protocol (MCP) 的后端服务，旨在为大型语言模型 (LLM) 客户端提供访问 Hacker News 资讯的工具。通过此服务器，LLM 可以获取 Hacker News 上的各种类型文章，例如头条新闻、最新文章、提问帖、展示帖和招聘信息，并以结构化的 JSON 格式进行处理，方便 LLM 理解和利用这些信息。

主要功能点

获取多种类型的 Hacker News 文章：支持抓取头条 (top)、最新 (new)、提问 (ask)、展示 (show) 和招聘 (jobs) 等类型的文章。
结构化数据输出：返回的文章数据包含标题、URL、得分、作者、发布时间、评论数和排名等详细信息，方便 LLM 理解和处理。
可配置的文章数量限制：允许用户通过参数 'limit' 设置返回的文章数量，最多返回 30 篇文章。
完善的错误处理：提供清晰的错误提示和处理机制，确保服务的稳定性和可靠性。

安装步骤

克隆仓库：打开终端，执行以下命令克隆代码仓库到本地：

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

安装依赖：在项目根目录下，执行以下命令安装项目依赖：
```
npm install
```
构建服务器：执行以下命令构建服务器代码：
```
npm run build
```

服务器配置

要将 Hacker News MCP 服务器配置到 MCP 客户端（例如 Claude），您需要提供服务器的启动命令和参数。以下是配置信息，请根据您的实际 'hn-server' 路径进行调整。

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

配置参数说明:

'server name': 'hacker-news' (服务器名称，可以自定义，用于在客户端中引用)
'command': 'node' (启动服务器的命令，这里使用 Node.js 运行时)
'args': '["/path/to/hn-server/build/index.js"]' (命令参数，指向编译后的服务器入口文件 'index.js' 的绝对路径。请将 '/path/to/hn-server' 替换为您的实际项目路径)

例如，如果您的 'hn-server' 项目位于用户目录下的 'Documents/hn-server' 文件夹中，则配置应如下所示 (macOS/Linux):

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

在 Windows 系统中，路径格式可能类似:

{
  "mcpServers": {
    "hacker-news": {
      "command": "node",
      "args": ["C:\\Users\\your_username\\Documents\\hn-server\\build\\index.js"]
    }
  }
}

请根据您使用的 MCP 客户端（如 Claude 桌面应用或 VSCode 插件）的配置文件位置，将以上 JSON 配置信息添加到相应的配置文件中。

基本使用方法

配置完成后，您可以使用 MCP 客户端的自然语言交互功能来指示 LLM 使用 Hacker News MCP 服务器。

工具名称: 'get_stories'

参数:

'type' (字符串): 要获取的文章类型。
- 可选值: 'top', 'new', 'ask', 'show', 'jobs'。
- 默认值: 'top'。
'limit' (数字): 返回的文章数量限制。
- 取值范围: 1-30。
- 默认值: 10。

使用示例 (假设在 Claude 中使用):

"Show me the top 5 stories from Hacker News" (获取 5 篇头条文章)
"What are the latest Ask HN posts?" (获取最新的提问文章，数量默认为 10)
"Get me the top 3 Show HN submissions from today" (获取 3 篇展示文章)

LLM 会根据您的自然语言指令，自动调用 'get_stories' 工具，并根据上下文推断或要求您提供必要的参数，最终从 Hacker News 获取您想要的文章信息。

关键词