Hacker NewsSAFE

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 (top, new, ask, show, jobs).

Features

• 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

Installation

1. Clone the repository:

git clone https://github.com/pskill9/hn-server
cd hn-server

1. Install dependencies:

npm install

1. Build the server:

npm run build

1. Add to your MCP settings configuration file (location depends on your system):

For VSCode Claude extension:

{
"mcpServers": {
"hacker-news": {
"command": "node",
"args": ["/path/to/hn-server/build/index.js"]
}
}
}

Usage

The server provides a tool called get_stories that can be used to fetch stories from Hacker News.

Tool: get_stories

Parameters:

• type (string): Type of stories to fetch
• Options: 'top', 'new', 'ask', 'show', 'jobs'
• Default: 'top'
• limit (number): Number of stories to return
• Range: 1-30
• Default: 10

Example usage:

use_mcp_tool with:
server_name: "hacker-news"
tool_name: "get_stories"
arguments: {
"type": "top",
"limit": 5
}

Sample output:

[
{
"title": "Example Story Title",
"url": "https://example.com/story",
"points": 100,
"author": "username",
"time": "2024-12-28T00:03:05",
"commentCount": 50,
"rank": 1
},
// ... more stories
]

Integrating with Claude

To use this MCP server with Claude, you'll need to:

1