Hn MCP

🚀 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 (字符串)：用户名
• 返回：用户提交的故事和评论数组

🤝 贡献

1. 叉取仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建新的 Pull Request

📄 许可证

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

ℹ️ 关于

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