金大哥 - hn-mcp MCP 详情

article

README

🚀 Hacker 新闻 MCP 服务器

官方的 Hacker 新闻 MCP 服务器——为 Cursor、Claude 和任何其他 LLM 客户端添加强大的 Hacker 新闻集成。通过 Model Context Protocol 访问故事、评论、用户资料和搜索功能。

🚀 快速开始

本 Hacker 新闻 MCP 服务器能够为各类 LLM 客户端提供强大的 Hacker 新闻集成能力，让你通过 Model Context Protocol 轻松访问 Hacker 新闻的各类数据。

✨ 主要特性

使用 Algolia 的 HN Search API 搜索故事和评论
根据类型（top、new、best、ask、show、job）获取多个故事
获取带有评论的故事
获取评论树和用户讨论
获取用户资料和提交内容
实时访问 Hacker 新闻数据

📦 安装指南

在 Claude Desktop 上运行

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "hackernews": {
      "command": "npx",
      "args": ["-y", "@devabdultech/hn-mcp-server"]
    }
  }
}

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Hacker 新闻 MCP 服务器：

npx -y @smithery/cli install @devabdultech/hn-mcp --client claude

💻 使用示例

基础用法

本服务器提供了多个实用工具，以下为各工具的使用说明：

`search`

使用 Algolia 的搜索 API 在 Hacker 新闻上搜索故事和评论
输入：
- query (字符串)：搜索查询
- type (可选字符串)：按类型过滤 ('story' 或 'comment')
- page (可选数字)：页码
- hitsPerPage (可选数字)：每页结果数（最多 100）
返回：搜索结果，包括故事和评论

`getStories`

根据类型获取多个故事
输入：
- type (字符串)：要获取的故事类型 ('top', 'new', 'best', 'ask', 'show', 'job')
- limit (可选数字)：获取的故事数量（最多 100）
返回：故事对象数组

`getStoryWithComments`

获取一个故事及其评论线程
输入：
- id (数字)：故事 ID
返回：带有嵌套评论的故事详细信息

`getCommentTree`

获取故事的完整评论树
输入：
- storyId (数字)：故事 ID
返回：分层评论树结构

`getUser`

获取用户的个人资料信息
输入：
- id (字符串)：用户名
返回：用户资料详细信息，包括魅力值、创建日期和简介文本

`getUserSubmissions`

获取用户的提交内容（故事和评论）
输入：
- id (字符串)：用户名
返回：用户提交的故事和评论数组

🤝 贡献

叉取仓库
创建功能分支
提交更改
推送到分支
创建新的 Pull Request

📄 许可证

此 MCP 服务器根据 MIT 许可证发布。有关详细信息，请参阅 LICENSE 文件。

ℹ️ 关于

此 MCP 服务器由 devabdultech 构建和维护。它使用官方的 Hacker 新闻 API 和 Algolia 搜索 API，通过 Model Context Protocol 提供对 Hacker 新闻数据的全面访问。

hn-mcp