麦克佩斯-克劳德-黑客新闻
项目介绍
MCP Claude Hacker News
功能
- 浏览 Hacker News 上最新的故事
- 查看排名靠前和评价最高的故事
- 获取故事详情
- 阅读故事评论
- 清晰地格式化 Hacker News 内容以提高可读性
演示
<p> <a href="https://www.youtube.com/watch?v=SmPD6MLifJo"> <img src="public/assets/preview.png" width="600" alt="Claude Spotify 集成演示"> </a> </p>要求
- Node.js 16 或更高版本
- Claude Desktop
- 访问 Hacker News API 的互联网连接
安装
手动安装
- 克隆或下载此仓库：
git clone https://github.com/imprvhub/mcp-claude-hackernews
cd mcp-claude-hackernews
- 安装依赖项：
npm install
- 构建项目：
npm run build
运行 MCP 服务器
有两种方法可以运行 MCP 服务器：
方案 1：手动运行
- 打开终端或命令提示符
- 导航到项目目录
- 直接运行服务器：
node build/index.js
使用 Claude Desktop 时，请保持终端窗口打开。服务器将在您关闭终端之前一直运行。
方案 2：自动启动（推荐用于常规使用）
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"]
}
}
}
重要：用您安装 MCP 的完整绝对路径替换 ABSOLUTE_PATH_TO_DIRECTORY
- 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_config.json 文件中的配置，当 Claude Desktop 需要时，MCP 服务器会自动启动。
使用方法
- 修改配置后重启 Claude Desktop
- 在 Claude 中使用 Hacker News 工具进行交互
- MCP 服务器作为由 Claude Desktop 管理的子进程运行
可用工具
Hacker News MCP 提供了5个专用工具用于不同的功能：
| 工具 | 描述 | 参数 | 示例用法 |
|---|---|---|---|
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_story | 获取特定故事的详细信息 | story_id: 必需的故事 ID（数字） | 通过 ID 获取故事详情 |
hn_comments | 获取故事的评论 | story_id: 故事 ID（数字）或 story_index: 上次列表中的索引（从 1 开始） | 通过故事 ID 或索引获取评论 |
工具参数细节
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（对于上次列表中的第 3 个故事）
注意：对于 hn_comments，必须提供 story_id 或 story_index
示例用法
这里有一些使用 Hacker News MCP 与 Claude 的不同示例：
直接工具使用：
"使用 hn_latest 获取 20 个最近的故事"
"使用 hn_top 并设置 limit 为 15 来获取顶级故事"
"使用 hn_best 获取 25 个最佳故事"
"使用 hn_story 并设置 story_id 为 29384756 来获取故事详情"
"使用 hn_comments 并设置 story_index 为 3 来获取第 3 个故事的评论"
"使用 hn_comments 并设置 story_id 为 12345678 来获取该故事的评论"
自然语言查询：
您还可以使用自然语言与 MCP 进行交互。Claude 将解释这些请求并使用适当的工具：
- "给我看看今天 Hacker News 上排名前 30 的故事"
- "Hacker News 上最新的 40 篇帖子是什么？"
- "我想看看来自 Hacker News 的 20 篇最佳文章"
- "你能给我找来 30 篇最近的科技新闻吗？"
- "告诉我 Hacker News 上目前最热门的 50 个话题"
- "给我展示 20 篇关于机器学习的 Hacker News 文章"
- "获取最近 40 个 Hacker News 标题"
- "现在 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: 服务器断开连接"：
-
验证服务器是否正在运行：
- 打开终端并手动从项目目录运行
node build/index.js - 如果服务器成功启动，请在使用 Claude 时保持终端窗口打开
- 打开终端并手动从项目目录运行
-
检查您的配置：
- 确保
claude_desktop_config.json文件中的绝对路径对您的系统是正确的 - 对于 Windows 路径，确保使用双反斜杠 (
\\) - 验证您是否使用了从文件系统根开始的完整路径
- 确保
-
尝试自动启动选项：
- 根据“设置自动启动脚本”部分的描述，为您的操作系统设置自动启动脚本
- 这样可以确保服务器在您需要时始终运行
工具未出现在 Claude 中
如果 Hacker News 工具没有出现在 Claude 中：
- 确保您在配置后已重启 Claude Desktop
- 检查 Claude Desktop 日志中的任何 MCP 通信错误
- 确保 MCP 服务器进程正在运行（手动运行以确认）
- 验证 MCP 服务器是否正确注册在 Claude Desktop MCP 注册表中
检查服务器是否正在运行
要检查服务器是否正在运行：
- Windows：打开任务管理器，转到“详细信息”标签页，查找 "node.exe"
- macOS/Linux：打开终端并运行
ps aux | grep node
如果没有看到服务器正在运行，请手动启动或使用自动启动方法。
贡献
欢迎贡献！请随时提交拉取请求。
许可证
本项目根据 Mozilla Public License 2.0 授权 - 详情见 LICENSE 文件。