Hn MCP

🚀 Hacker 新闻 MCP 服务器

官方的 Hacker 新闻 MCP 服务器，能为 Cursor、Claude 以及其他任何 LLM 客户端添加强大的 Hacker 新闻集成功能。借助 Model Context Protocol，可实现对故事、评论、用户资料的访问以及搜索功能。

🚀 快速开始

此 Hacker 新闻 MCP 服务器可按以下方式进行设置：

在 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

✨ 主要特性

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

📚 详细文档

工具

1. search

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

2. getStories

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

3. getStoryWithComments

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

4. getCommentTree

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

5. getUser

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

6. getUserSubmissions

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

贡献

若你想为该项目贡献代码，可按以下步骤操作：

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

📄 许可证

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

关于

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