MCP Claude Hacker News

功能

• 浏览Hacker News的最新故事
• 查看顶级和高评分的故事
• 获取故事详情
• 阅读故事评论
• 清晰格式化Hacker News内容以提高可读性

演示

要求

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

安装

手动安装

1. 克隆或下载此仓库：
   bash
   git clone https://github.com/imprvhub/mcp-claude-hackernews
   cd mcp-claude-hackernews

2. 安装依赖项：
   bash
   npm install

3. 构建项目：
   bash
   npm run build

运行MCP服务器

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

选项1：手动运行

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

bash
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%Claudeclaude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

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

json
{
"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

如果你已经配置了其他MCPs，只需在mcpServers对象中添加hackerNews部分即可。以下是一个包含多个MCPs的配置示例：

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

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

使用方法

1. 修改配置后重启Claude Desktop
2. 在Claude中使用hn命令与Hacker News进行交互
3. MCP服务器作为子进程由Claude Desktop管理

可用命令

Hacker News MCP提供了一个名为hn的工具，包含多个命令：

| 命令 | 描述 | 参数 | 示例 |
|---------|-------------|------------|---------|| latest | 获取 Hacker News 的最新故事 | 参数: 可选的故事数量（默认：10，最大：50） | hn latest --50 |
| top | 获取 Hacker News 的热门故事 | 参数: 可选的故事数量（默认：10，最大：50） | hn top --20 |
| best | 获取 Hacker News 的最佳故事 | 参数: 可选的故事数量（默认：10，最大：50） | hn best --30 |
| history | 获取特定故事的详细信息 | 参数: 必需的故事 ID | hn history --12345678 |
| comments | 获取故事的评论 | 参数: 上一个列表中的必需索引或故事 ID | hn comments --3 或 hn comments --12345678 |

示例用法

以下是使用 Claude 与 Hacker News MCP 的各种示例：

直接命令：

hn latest --50
hn top --20
hn best --30
hn history --29384756
hn comments --5

自然语言查询：

您还可以使用自然语言与 MCP 进行交互。Claude 将解释这些请求并使用适当的命令：

• "显示今天 Hacker News 上的前 30 个故事"
• "Hacker News 上最新的 40 篇帖子是什么？"
• "我想看 Hacker News 上最好的 20 篇文章"
• "你能从 Hacker News 上为我获取 30 条最近的技术新闻吗？"
• "告诉我 Hacker News 上最热门的 50 个话题"
• "显示 20 篇关于机器学习的 Hacker News 故事"
• "给我获取 40 条最近的 Hacker News 标题"
• "现在 Hacker News 上最活跃的 30 个讨论是什么？"
• "我对阅读本周 Hacker News 上最受欢迎的 40 篇文章感兴趣"
• "显示来自 Hacker News 的 20 篇最佳编程文章列表"

语言翻译请求：

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

• "以西班牙语显示今天 Hacker News 上的前 30 个故事"
• "获取最新的 20 篇 Hacker News 帖子并将它们翻译成法语"
• "我想看 Hacker News 上最好的 40 篇德语文章"
• "显示 30 条最近的 Hacker News 故事并将其翻译成日语"
• "获取 Hacker News 上排名前 20 的文章，并以葡萄牙语呈现"

故障排除

"服务器断开连接" 错误

如果您在 Claude Desktop 中看到错误 "MCP Hacker News: Server disconnected"：

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

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

贡献

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

许可证

该项目根据 Mozilla Public License 2.0 许可 - 详情请参阅 LICENSE 文件。

相关链接

• Model Context Protocol- Hacker News API
• Claude Desktop

翻译如下：

• Hacker News API
• Claude 桌面版