JinDaGe - hn-server MCP Details

article

README

🚀 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，您可以在自己的项目中自由使用。

hn-server