使用说明

项目简介

Hacker News MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 LLM (大型语言模型) 客户端提供便捷的 Hacker News 数据访问能力。通过此服务器，LLM 可以利用预设的工具，检索 Hacker News 上的新闻、评论、用户资料等信息，从而增强 LLM 在技术资讯领域的上下文理解和应用能力。

主要功能点

强大的搜索功能：利用 Algolia 搜索 API，可以根据关键词快速检索 Hacker News 上的新闻和评论。
多样化的新闻获取方式：支持按类型（如：热门、最新、最佳、提问、展示、招聘）获取新闻列表，方便 LLM 客户端获取不同类别的新闻资讯。
深入的内容挖掘：可以获取单条新闻及其完整的评论树，帮助 LLM 深入理解新闻事件和用户观点。
全面的用户画像：支持获取 Hacker News 用户个人资料和提交记录，为 LLM 提供更丰富的用户上下文信息。
实时数据访问：服务器直接对接 Hacker News API 和 Algolia Search API，确保 LLM 客户端获取的数据都是最新的。

安装步骤

由于这是一个 MCP 服务器，通常无需用户手动安装服务器端，而是由 LLM 客户端（如 Cursor 或 Claude）负责配置和启动。您需要确保您的 LLM 客户端支持 MCP 协议，并按照其文档进行服务器配置。

如果需要本地运行和开发，请确保您已安装 Node.js 和 npm，然后可以按照以下步骤操作（请注意，以下步骤为本地开发或了解项目结构，实际使用时通常无需手动安装服务器端，而是配置客户端即可）：

克隆仓库到本地：

git clone https://github.com/devabdultech/hn-mcp.git
cd hn-mcp

安装依赖：
```
npm install
```
构建项目 (如果需要)：
```
npm run build
```
启动服务器：
```
npm start
```

服务器配置

对于支持 MCP 协议的 LLM 客户端，您通常需要在客户端的配置文件中添加 MCP 服务器的配置信息。以 Claude Desktop 为例，您需要编辑 'claude_desktop_config.json' 文件，并添加如下配置：

{
  "mcpServers": {
    "hackernews": {
      "command": "npx",
      "args": ["-y", "@devabdultech/hn-mcp-server"]
    }
  }
}

配置参数说明：

'"hackernews"': MCP 服务器的名称，可以自定义，用于在客户端中引用。
'"command": "npx"': 启动服务器的命令，这里使用 'npx' 来运行 npm 包。
'"args": ["-y", "@devabdultech/hn-mcp-server"]': 'npx' 命令的参数，'-y' 表示自动确认安装包，'@devabdultech/hn-mcp-server' 是 Hacker News MCP Server 的 npm 包名。

基本使用方法

配置完成后，您的 LLM 客户端应该能够连接到 Hacker News MCP Server。您可以通过自然语言指令指示 LLM 使用以下工具来访问 Hacker News 数据：

'search': 在 Hacker News 上搜索新闻或评论。例如，您可以让 LLM “使用 'search' 工具搜索关于人工智能的新闻”。
'getStories': 获取指定类型的新闻列表（如 'top', 'new', 'best' 等）。例如，让 LLM “使用 'getStories' 工具获取 'top' 类型的新闻”。
'getStoryWithComments': 获取指定 ID 的新闻及其评论。例如，让 LLM “使用 'getStoryWithComments' 工具获取 ID 为 '123456' 的新闻”。
'getCommentTree': 获取指定新闻 ID 的完整评论树。
'getUser': 获取指定用户名的用户信息。例如，让 LLM “使用 'getUser' 工具获取用户名为 'pg' 的信息”。
'getUserSubmissions': 获取指定用户提交的新闻和评论。

请参考您的 LLM 客户端的文档，了解如何通过自然语言或特定指令调用这些工具，并利用 Hacker News 数据增强 LLM 的能力。

关键词

使用说明

信息