Hacker News MCP Server logo

Hacker News MCP Server

by pskill9

A Model Context Protocol (MCP) server that provides tools for fetching stories from Hacker News. This server parses the HTML content from news.ycombinator.com and provides structured data for different types of stories.

View on GitHub

Last updated: N/A

What is Hacker News MCP Server?

This is a Model Context Protocol (MCP) server designed to fetch and structure data from Hacker News. It parses the HTML content and provides structured data for different story types.

How to use Hacker News MCP Server?

  1. Clone the repository, 2. Install dependencies using npm install, 3. Build the server using npm run build, 4. Configure the server in your MCP settings (e.g., Claude desktop app or VSCode extension) by providing the path to the built index.js file, 5. Use Claude's natural language interface to interact with Hacker News using the get_stories tool.

Key features of Hacker News MCP Server

  • Fetch different types of stories (top, new, ask, show, jobs)

  • Get structured data including titles, URLs, points, authors, timestamps, and comment counts

  • Configurable limit on number of stories returned

  • Clean error handling and validation

Use cases of Hacker News MCP Server

  • Fetching top Hacker News stories for a summary

  • Monitoring new 'Ask HN' posts for relevant questions

  • Tracking 'Show HN' submissions for interesting projects

  • Gathering data for analysis of Hacker News trends

FAQ from Hacker News MCP Server

What story types can I fetch?

You can fetch 'top', 'new', 'ask', 'show', and 'jobs' stories.

What data is included in each story object?

Each story object includes the title, URL, points, author, timestamp, comment count, and rank.

How do I configure the server for the Claude desktop app?

Add the server configuration to the claude_desktop_config.json file in the appropriate directory for your operating system.

What is the valid range for the limit parameter?

The limit parameter must be between 1 and 30.

How do I contribute to this project?

Feel free to submit a Pull Request with your contributions.