MCP Claude Hacker News

MCP Claude Hacker News

此集成使用 Model Context Protocol（MCP）让 Claude Desktop 与 Hacker News 交互。

功能

• 浏览 Hacker News 最新故事
• 查看热门和评分最高的故事
• 按关键词搜索故事，可按相关性或最新时间排序（Algolia HN Search API）
• 获取故事详情
• 阅读故事评论，并限制评论数量，避免热门讨论串占满上下文
• 清晰排版 Hacker News 内容，提升可读性，并解码 HTML 实体

演示

要求

• Node.js 20 或更高版本
• Claude Desktop
• 访问 Hacker News API 的互联网连接

安装

通过 Smithery 安装

从 Smithery 服务页面安装打包后的套件，或通过命令行安装：

npx -y @smithery/cli@latest mcp add imprvhub/mcp-claude-hackernews --client claude

手动安装

1. 克隆或下载此仓库：

git clone https://github.com/imprvhub/mcp-claude-hackernews
cd mcp-claude-hackernews

2. 安装依赖：

npm install

3. 构建项目：

npm run build

运行 MCP 服务

有两种运行 MCP 服务的方式：

选项 1：手动运行

1. 打开终端或命令提示符
2. 进入项目目录
3. 直接运行服务：

node build/index.js

使用 Claude Desktop 时，请保持此终端窗口打开。关闭终端后，服务将停止运行。

选项 2：随 Claude Desktop 自动启动（推荐日常使用）

Claude Desktop 可以在需要时自动启动 MCP 服务。设置方法如下：

配置

Claude Desktop 配置文件位于：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

编辑此文件，添加 Hacker News MCP 配置。如果文件不存在，请创建该文件：

{
  "mcpServers": {
    "hackerNews": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_DIRECTORY/mcp-claude-hackernews/build/index.js"]
    }
  }
}

重要提示：将 ABSOLUTE_PATH_TO_DIRECTORY 替换为安装 MCP 的完整绝对路径

• macOS/Linux 示例：/Users/username/mcp-claude-hackernews
• Windows 示例：C:\\Users\\username\\mcp-claude-hackernews

如果已配置其他 MCP，只需在 "mcpServers" 对象中添加 "hackerNews" 部分。以下是包含多个 MCP 的配置示例：

{
  "mcpServers": {
    "otherMcp1": {
      "command": "...",
      "args": ["..."]
    },
    "otherMcp2": {
      "command": "...",
      "args": ["..."]
    },
    "hackerNews": {
      "command": "node",
      "args": [
        "ABSOLUTE_PATH_TO_DIRECTORY/mcp-claude-hackernews/build/index.js"
      ]
    }
  }
}

Claude Desktop 将根据 claude_desktop_config.json 文件中的配置，在需要时自动启动 MCP 服务。

使用方法

1. 修改配置后，重启 Claude Desktop
2. 在 Claude 中使用 Hacker News 工具与 Hacker News 交互
3. MCP 服务作为由 Claude Desktop 管理的子进程运行

可用工具

Hacker News MCP 提供 6 个专用工具，用于不同功能：

工具	描述	参数	使用示例
hn_latest	获取 Hacker News 上最新的文章	limit：可选的文章数量（1-50，默认值：10）	获取最新的 20 篇文章
hn_top	获取 Hacker News 上排名最高的文章	limit：可选的文章数量（1-50，默认值：10）	获取排名最高的 15 篇文章
hn_best	获取 Hacker News 上最受好评的文章	limit：可选的文章数量（1-50，默认值：10）	获取最受好评的 25 篇文章
hn_search	按关键词搜索文章	query：必需的搜索词；limit：1-50（默认值：10）；sort：relevance（默认值）或 date	按日期排序，搜索“rust async”
hn_story	获取特定文章的详细信息	story_id：必需的文章 ID（数字）	根据 ID 获取文章详情
hn_comments	获取文章的顶层评论	story_id：文章 ID（数字）或 story_index：上次列表中的索引（从 1 开始）；limit：1-50（默认值：20）	根据文章 ID 或索引获取评论

工具参数详情

hn_latest、hn_top、hn_best

• limit（可选）：要获取的文章数量
  • 类型：数字
  • 范围：1-50
  • 默认值：10

hn_search

• query（必需）：搜索词
  • 类型：字符串
  • 示例："model context protocol"
• limit（可选）：结果数量，1-50，默认值为 10
• sort（可选）：relevance（默认值）或 date（按最新内容优先）

hn_story

• story_id（必需）：要获取的文章 ID
  • 类型：数字
  • 示例：12345678

hn_comments

• story_id（可选）：要获取评论的文章 ID
  • 类型：数字
  • 示例：12345678
• story_index（可选）：上次获取的列表中的文章索引
  • 类型：数字（从 1 开始）
  • 示例：3（上次列表中的第 3 篇文章）
• limit（可选）：要返回的顶层评论的最大数量
  • 类型：数字
  • 范围：1-50
  • 默认值：20

注意：对于 hn_comments，必须提供 story_id 或 story_index。只会获取顶层评论；每条评论都会报告回复数。响应会说明返回了该讨论串中多少条顶层评论。

使用示例

以下是一些使用 Claude 操作 Hacker News MCP 的示例：

直接使用工具：

"Use hn_latest to get 20 recent stories"
"Use hn_top with limit 15 to get top stories"
"Use hn_best to get 25 best stories"
"Use hn_search with query 'model context protocol' to find related stories"
"Use hn_search with query 'rust' and sort date to see the newest posts"
"Use hn_story with story_id 29384756 to get story details"
"Use hn_comments with story_index 3 to get comments for the 3rd story"
"Use hn_comments with story_id 12345678 to get comments for that story"

自然语言查询：

你也可以使用自然语言与 MCP 交互。Claude 会理解这些请求并使用适当的工具：

• “显示今天 Hacker News 上排名最高的 30 篇文章”
• “Hacker News 上最新的 40 篇帖子有哪些？”
• “我想看看 Hacker News 上最受好评的 20 篇文章”
• “能帮我获取 Hacker News 上最近的 30 条科技新闻吗？”
• “告诉我 Hacker News 上排名最高的 50 个热门话题是什么”
• “搜索 Hacker News 上关于机器学习的文章”
• “获取 Hacker News 上最近的 40 条头条”
• “目前 Hacker News 上最活跃的 30 个讨论是什么？”
• “我想看看本周 Hacker News 上最受欢迎的 40 篇文章”
• “显示 Hacker News 上 20 篇最好的编程文章”
• “获取上次列表中第 5 篇文章的评论”
• “显示文章 ID 为 12345678 的详情”

语言翻译请求：

你可以请求将 Hacker News 内容翻译成不同语言：

• “用西班牙语显示今天 Hacker News 上排名最高的 30 篇文章”
• “获取 Hacker News 上最新的 20 篇帖子并将其翻译成法语”
• “我想看看 Hacker News 上德语的 40 篇最佳文章”
• “显示翻译成日语的 30 篇 Hacker News 最新文章”
• “获取 Hacker News 上排名最高的 20 篇文章，并用葡萄牙语呈现”

故障排除

“服务器已断开连接”错误

如果你在 Claude Desktop 中看到错误“MCP Hacker News：服务器已断开连接”：

1. 确认服务正在运行：

   • 打开终端，并在项目目录中手动运行 node build/index.js
   • 如果服务成功启动，请保持终端打开并使用 Claude

2. 检查配置：

   • 确保 claude_desktop_config.json 中的绝对路径适用于你的系统
   • 再次确认 Windows 路径使用了双反斜杠（\\）
   • 确认使用的是从文件系统根目录开始的完整路径

3. 尝试自动启动选项：

   • 按照“设置自动启动脚本”部分的说明，为你的操作系统设置自动启动脚本
   • 这样可以确保你需要时服务始终在运行

Claude 中未显示工具

如果 Hacker News 工具未显示在 Claude 中：

• 确保配置后已重启 Claude Desktop
• 查看 Claude Desktop 日志，确认是否存在 MCP 通信错误
• 确保 MCP 服务进程正在运行（手动运行以确认）
• 确认 MCP 服务已在 Claude Desktop MCP 注册表中正确注册

检查服务是否正在运行

检查服务是否正在运行：

• Windows：打开任务管理器，转到“详细信息”选项卡，然后查找“node.exe”
• macOS/Linux：打开终端并运行 ps aux | grep node

如果服务未在运行，请手动启动，或使用自动启动方法。

开发

运行测试套件（无需网络）：

npm install
npm run build
npm test

贡献

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

许可证

本项目采用 Mozilla Public License 2.0 授权，详情请参阅 LICENSE 文件。

相关链接

• Model Context Protocol
• Hacker News API
• Claude Desktop
• MCP Series