MCP Claude Hackernews

MCP克劳德黑客新闻

](https://smithery.ai/server/@imprvhub/mcp-claude-hackernews)

An integration that allows Claude Desktop to interact with Hacker News using the Model Context Protocol (MCP).

特性

• 浏览Hacker News的最新报道
• 查看热门和评价最高的故事
• 获取故事详情
• 阅读故事评论
• 黑客新闻内容的干净格式，以提高可读性

演示

需求

• Node.js 16或更高版本
• 克劳德桌面
• 互联网连接访问Hacker News API

安装

手动安装

1. 克隆或下载此存储库：

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

1. 安装依赖项：

npm install

1. 构建项目：

npm run build

运行MCP服务器

有两种方法可以运行MCP服务器：

选项1：手动运行

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

node build/index.js

使用Claude Desktop时，请保持此终端窗口打开。服务器将一直运行，直到您关闭终端。

选项2：使用Claude Desktop自动启动（建议常规使用）

克劳德桌面可以在需要时自动启动MCP服务器。要设置此项，请执行以下操作：

配置

Claude Desktop配置文件位于：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %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需要时，MCP服务器将根据您的配置自动启动 claude_desktop_config.json 文件。

用法

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

可用工具

黑客新闻MCP提供 5专用工具 对于不同的功能：

工具参数详细信息

hn_latest, hn_top, hn_best

• limit （可选）：要获取的故事数

- 类型：编号 - 范围：1-50 - 默认值：10

hn_story

• story_id （必填）：要获取的故事的ID

- 类型：编号 - 示例：12345678

hn_comments

• story_id （可选）：获取评论的故事ID

- 类型：编号 - 示例：12345678

• story_index （可选）：上次获取的列表中的故事索引

- 类型：数字（从1开始） - 示例：3（最后一个列表中的第三个故事）

*注：用于 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_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将解释这些请求并使用适当的工具：

• “给我看看今天黑客新闻的前30个故事”
• “黑客新闻上最新的40条帖子是什么？”
• “我想看看黑客新闻的20篇最佳文章”
• “你能帮我从黑客新闻上取30条最新的科技新闻吗？”
• “告诉我黑客新闻上最热门的50个话题是什么”
• “给我看20个关于机器学习的黑客新闻故事”
• “给我40个最新的黑客新闻头条”
• “目前黑客新闻上最活跃的30个讨论是什么？”
• “我有兴趣阅读本周最受欢迎的40篇黑客新闻文章”
• “给我看Hacker News的20篇最佳编程文章列表”
• “从最后一个列表中获取第5个故事的评论”
• “显示故事ID 12345678的详细信息”

语言翻译请求：

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

• “用西班牙语给我看看今天黑客新闻的前30个故事”
• “获取20条最新的黑客新闻帖子并将其翻译成法语”
• “我想看看德国黑客新闻的40篇最佳文章”
• “给我看30个最近被翻译成日语的黑客新闻故事”
• “获取前20名黑客新闻文章，并用葡萄牙语呈现”

故障排除

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

如果您在Claude Desktop中看到错误“MCP黑客新闻：服务器已断开连接”：

1. 验证服务器是否正在运行:

- 打开终端并手动运行 node build/index.js 从项目目录 - 如果服务器成功启动，请在保持此终端打开的同时使用Claude

1. 检查您的配置:

- 确保绝对路径 claude_desktop_config.json 适用于您的系统 - 仔细检查你是否使用了双睫毛(\\)对于Windows路径 - 验证您使用的是从文件系统根目录开始的完整路径

1. 尝试自动启动选项:

- 按照“设置自动启动脚本”一节中的说明为您的操作系统设置自动启动剧本 - 这确保了服务器在您需要时始终运行

工具未出现在Claude中

如果黑客新闻工具没有出现在Claude中：

• 确保配置后重新启动了Claude Desktop
• 检查Claude Desktop日志中是否存在任何MCP通信错误
• 确保MCP服务器进程正在运行（手动运行以确认）
• 验证MCP服务器是否在Claude Desktop MCP注册表中正确注册

检查服务器是否正在运行

要检查服务器是否正在运行，请执行以下操作：

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

如果您没有看到服务器正在运行，请手动启动或使用自动启动方法。

贡献

欢迎投稿！请随时提交拉取请求。

许可证

此项目根据Mozilla公共许可证2.0获得许可-请参阅 许可证 文件以获取详细信息。

相关链接

• 模型上下文协议
• 黑客新闻API
• 克劳德桌面
• MCP系列