mcpField
H
Hacker News MCP Server

Hacker News MCP Server

Local
github.com/erithwikSocial Media76Updated 67w ago
Repository

About Hacker News MCP Server

Hacker News MCP Server is an MCP server that fetches information from Hacker News, including story lists, comments, search results and user profiles. It suits users who want an assistant to look up Hacker News content directly. The README includes example prompts showing how it can be combined with other MCP servers.

Key features

  1. 01Fetch top, new, Ask HN and Show HN stories
  2. 02Retrieve comments for a given story
  3. 03Search stories by query
  4. 04Look up user information and activity

Use cases

  1. 01Asking an assistant to summarize today's top stories
  2. 02Reading and summarizing comments on a specific story
  3. 03Searching Hacker News discussions on a topic

MCP support

This project is an MCP server that exposes tools such as get_stories, get_story_info, search_stories and get_user_info to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "hn": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Hacker News MCP Server

smithery badge

A Model Context Protocol (MCP) server that provides tools for fetching information from Hacker News.

mcp-hn MCP server

Tools

  • get_stories Fetching (top, new, ask_hn, show_hn) stories
  • get_story_info Fetching comments associated with a story
  • search_stories Searching for stories by query
  • get_user_info Fetching user info

Example Usage

Use prompts like the following:

User: Get the top stories of today
  Output: Uses `get_stories` tool and returns a story about AI
User: What does the details of the story today that talks about the future of AI
  Output: Uses `get_story_info` tool based on the results of the previous tool
User: What has the user `pg` been up to?
  Output: Uses `get_user_info` tool and returns a summary of the user's activity
User: What does hackernews say about careers in AI?
  Output: Uses `search_stories` tool and returns a summary of the comments

A more detailed example with the puppeteer MCP server:

User: What are the top stories of today?
  Output: Uses `get_stories` tool and returns a story about AI
User: Can you use the puppeteer tool to read the article about <AI> and also use the hackernews tool to view the comments and give me a summary of what the main comments are about the article?
  Output: Uses puppeteer tool to read the article about AI and then uses the `get_story_info` hn tool to get the comments and returns a summary of the comments

Quickstart

Installing via Smithery

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

npx -y @smithery/cli install mcp-hn --client claude
Claude Desktop:

Update the following:

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%/Claude/claude_desktop_config.json

With the following for production:

{
  "mcpServers": {
    "mcp-hn": {
      "command": "uvx",
      "args": ["mcp-hn"]
    }
  }
}

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.