navascogt/mcp-hackernews
If you are the rightful owner of mcp-hackernews and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
MCP Server to query Hackernews provides a structured way to access and interact with Hackernews data using the Model Context Protocol.
mcp-hackernews
An MCP (Model Context Protocol) server that provides tools to interact with the Hacker News API. This server allows you to search, retrieve, and query various Hacker News data including stories, comments, users, and more.
Features
This MCP server exposes the following tools:
Search Tools
- search_posts: Search posts using Algolia's Hacker News search API with support for tags, numeric filters, and pagination
- search_by_date: Search posts by date with similar filtering capabilities
Story Retrieval Tools
- get_top_stories: Retrieve the top stories from Hacker News
- get_new_stories: Get the newest stories
- get_best_stories: Fetch the highest-rated stories
- get_ask_stories: Retrieve Ask HN stories
- get_show_stories: Get Show HN stories
- get_job_stories: Fetch job postings
Item and User Tools
- get_item: Retrieve details of a specific item (story, comment, etc.) by ID
- get_user: Get user profile information by username
Utility Tools
- get_max_item_id: Get the current maximum item ID
- get_updates: Retrieve recent updates from Hacker News
Installation
- Clone this repository
- Install dependencies:
npm install - Build the server:
npm run build - Start the server:
npm start
Usage
This server communicates via stdio and is designed to be used with MCP-compatible clients. It uses the official Hacker News APIs:
- Algolia Search API for search functionality
- Firebase API for item and user data
All responses are returned as JSON for easy parsing and integration.