Hn MCP

🚀 Hacker News MCP Server

The official Hacker News MCP server that adds powerful Hacker News integration to Cursor, Claude, and any other LLM clients. Access stories, comments, user profiles, and search functionality via the Model Context Protocol.

🚀 Quick Start

This Hacker News MCP server provides seamless access to Hacker News data. You can set it up following the steps below.

✨ Features

• Search for stories and comments using Algolia's HN Search API.
• Fetch multiple stories based on types (top, new, best, ask, show, job).
• Retrieve stories with comments.
• Get comment trees and user discussions.
• Obtain user profiles and submitted content.
• Access Hacker News data in real-time.

📦 Installation

Run on Claude Desktop

Add the following to claude_desktop_config.json:

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

Install via Smithery

To automatically install the Hacker News MCP server for Claude Desktop via Smithery:

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

📚 Documentation

Tools

1. search

   • Search for stories and comments on Hacker News using Algolia's search API.
   • Input: - query (string): Search query. - type (optional string): Filter by type ('story' or 'comment'). - page (optional number): Page number. - hitsPerPage (optional number): Number of results per page (max 100).
   • Return: Search results, including stories and comments.

2. getStories

   • Fetch multiple stories based on types.
   • Input: - type (string): Type of stories to fetch ('top', 'new', 'best', 'ask', 'show', 'job'). - limit (optional number): Number of stories to fetch (max 100).
   • Return: An array of story objects.

3. getStoryWithComments

   • Retrieve a story and its comment thread.
   • Input: - id (number): Story ID.
   • Return: Detailed story information with nested comments.

4. getCommentTree

   • Get the full comment tree of a story.
   • Input: - storyId (number): Story ID.
   • Return: Hierarchical comment tree structure.

5. getUser

   • Obtain user profile information.
   • Input: - id (string): Username.
   • Return: Detailed user profile, including karma, creation date, and bio text.

6. getUserSubmissions

   • Fetch user-submitted content (stories and comments).
   • Input: - id (string): Username.
   • Return: An array of user-submitted stories and comments.

Contributing

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the branch.
5. Create a new Pull Request.

📄 License

This MCP server is released under the MIT License. For more details, see the LICENSE file.

🔗 About

This MCP server is built and maintained by devabdultech. It uses the official Hacker News API and Algolia Search API to provide comprehensive access to Hacker News data via the Model Context Protocol.