mcp-registry/mcp-hn

    ==================
      
       /// MCP ///
      /// MCP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

mcp-hn

by erithwik

Model Context Protocol (MCP) server that exposes Hacker News tooling (get_stories, get_story_info, search_stories, get_user_info) for use from clients such as Claude Desktop via Smithery.

49
12
Specialized
GitHub

01

get_stories

Fetch top, new, ask_hn, or show_hn stories from Hacker News

02

get_story_info

Fetch comments associated with a specific story

03

search_stories

Search Hacker News stories by a query

04

get_user_info

Fetch information about a Hacker News user

Installation

1. Clone the server code
git clone https://github.com/erithwik/mcp-hn.git && cd mcp-hn
2. (Recommended) create and activate a virtual environment
python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate
3. Install Python dependencies
pip install -r requirements.txt # If a requirements.txt file is not present, run pip install -e .
4. Configuration
• Copy any sample environment file that ships with the repo (for example .env.example → .env).
• Provide your desired TCP port (default 3333), log-level and any optional HackerNews proxy keys.
5. Launch the MCP server
python -m mcp_hn # Typical entry point # or, if the project exposes an ASGI app (uvicorn) uvicorn mcp_hn.app:app --host 0.0.0.0 --port 3333 --reload
6. Verify
curl http://localhost:3333/healthz # Should return 200 OK

Documentation

License: MIT License
Updated 7/30/2025