What is Hn Mcp

hn-mcp is the official Hacker News MCP Server that integrates Hacker News data into various LLM clients like Cursor and Claude, allowing users to access stories, comments, user profiles, and search functionalities through the Model Context Protocol.

Use cases

Use cases for hn-mcp include building news aggregation tools, developing chatbots that provide Hacker News updates, creating analytics dashboards for user engagement, and enhancing LLM applications with real-time news content.

How to use

To use hn-mcp, add the provided configuration to your ‘claude_desktop_config.json’ file. This will enable you to run the server using the command ‘npx -y @devabdultech/hn-mcp-server’.

Key features

Key features of hn-mcp include searching stories and comments with Algolia’s HN Search API, retrieving stories by type (top, new, best, ask, show, job), accessing individual stories with comments, exploring comment trees and user discussions, and obtaining user profiles and submissions in real-time.

Where to use

hn-mcp can be used in various fields such as software development, data analysis, and content curation, particularly for applications that require real-time access to news data and user interactions.

Hacker News MCP Server

Official Hacker News MCP Server - Adds powerful Hacker News integration to Cursor, Claude, and any other LLM clients. Access stories, comments, user profiles, and search functionality through the Model Context Protocol.

Features

• Search stories and comments using Algolia’s HN Search API
• Get stories by type (top, new, best, ask, show, job)
• Get individual stories with comments
• Get comment trees and user discussions
• Get user profiles and submissions
• Real-time access to Hacker News data

Set Up

Running on Claude Desktop

Add this to your claude_desktop_config.json:

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

Installing via Smithery

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

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

Tools

1. search

   • Search for stories and comments on Hacker News using Algolia’s search API
   • Inputs:
     * query (string): Search query
     * type (optional string): Filter by type (‘story’ or ‘comment’)
     * page (optional number): Page number for pagination
     * hitsPerPage (optional number): Results per page (max 100)
   • Returns: Search results with stories and comments

2. getStories

   • Get multiple stories by type (top, new, best, ask, show, job)
   • Inputs:
     * type (string): Type of stories to fetch (‘top’, ‘new’, ‘best’, ‘ask’, ‘show’, ‘job’)
     * limit (optional number): Number of stories to fetch (max 100)
   • Returns: Array of story objects

3. getStoryWithComments

   • Get a story along with its comment thread
   • Inputs:
     * id (number): Story ID
   • Returns: Story details with nested comments

4. getCommentTree

   • Get the full comment tree for a story
   • Inputs:
     * storyId (number): ID of the story
   • Returns: Hierarchical comment tree structure

5. getUser

   • Get a user’s profile information
   • Inputs:
     * id (string): Username
   • Returns: User profile details including karma, created date, and about text

6. getUserSubmissions

   • Get a user’s submissions (stories and comments)
   • Inputs:
     * id (string): Username
   • Returns: Array of user’s submitted stories and comments

Contributing

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

License

This MCP server is licensed under the MIT License. See the LICENSE file for details.

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 through the Model Context Protocol.