🚀 Hacker News MCP 服务器
Hacker News MCP 服务器是一个实用的工具，它能从 Hacker News 获取各类故事。通过解析 news.ycombinator.com 的 HTML 内容，服务器可为热门、最新、提问、展示、工作等不同类型的故事提供结构化数据，满足多样的信息获取需求。
✨ 主要特性
- 支持获取多种类型的故事，涵盖热门、最新、提问、展示、工作等。
- 提供结构化数据，包含标题、URL、点数、作者、时间戳和评论数量等关键信息。
- 可灵活配置返回的故事数量，限制范围为 1 - 30 条。
- 具备清晰的错误处理和验证机制，保障服务的稳定性。
📦 安装指南
- 克隆项目仓库：
git clone https://github.com/pskill9/hn-server
cd hn-server
- 安装项目依赖：
npm install
- 构建服务器：
npm run build
- 将服务器添加到您的 MCP 设置配置文件中（具体位置取决于系统）：
对于 VSCode Claude 扩展，配置如下：
{
"mcpServers": {
"hacker-news": {
"command": "node",
"args": ["/path/to/hn-server/build/index.js"]
}
}
}
💻 使用示例
基础用法
该服务器提供了 get_stories 工具，用于从 Hacker News 获取故事。以下是该工具的参数说明：
type（字符串）：要获取的故事类型，可选值为 'top'、'new'、'ask'、'show'、'jobs'，默认值为 'top'。limit（数字）：要返回的故事数量，范围是 1 - 30，默认值为 10。
示例代码如下：
use_mcp_tool with:
server_name: "hacker-news"
tool_name: "get_stories"
arguments: {
"type": "top",
"limit": 5
}
样本输出
[
{
"title": "示例故事标题",
"url": "https://example.com/story",
"points": 100,
"author": "用户名",
"time": "2024-12-28T00:03:05",
"commentCount": 50,
"rank": 1
},
// ... 更多故事
]
📚 详细文档
集成到 Claude
若要将此 MCP 服务器与 Claude 集成，您需要完成以下步骤：
- 安装 Claude 桌面应用或 VSCode Claude 扩展。
- 在设置中配置 MCP 服务器。对于 Claude 桌面应用，配置如下：
{
"mcpServers": {
"hacker-news": {
"command": "node",
"args": ["/path/to/hn-server/build/index.js"]
}
}
}
- 使用 Claude 的自然语言接口与 Hacker News 进行交互。
错误处理
该服务器具备稳健的错误处理机制，可处理以下异常情况：
- 无效的故事类型
- 网络故障
- HTML 解析错误
- 无效参数值
错误会以适当的错误代码和描述消息返回，方便您进行排查和处理。
🤝 贡献
欢迎大家积极贡献代码！如果您有改进建议或新功能想法，请随时提交 Pull Request。
📄 许可证
本项目采用 MIT License，您可以在自己的项目中自由使用。