MCP Catalogs
← Home

hacker-mcp-server-POC

by sumitsk-simform·★ 1·Score 33

A lightweight MCP server exposing Hacker News data as tools for retrieving stories, details, and user profiles.

web-scrapingai-llmdeveloper-tools
0
Forks
0
Open issues
5 mo ago
Last commit
2d ago
Indexed

Overview

This is a well-structured MCP server written in TypeScript that provides access to Hacker News data through four main tools: get-news, get-news-detail, get-user-details, and search-news. The server utilizes the official @modelcontextprotocol/sdk and implements proper input validation using zod. It includes both development and production build processes, making it accessible for different use cases. The documentation covers installation, tool usage, and implementation details thoroughly.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Integrate Hacker News data into AI assistants to provide up-to-date tech news
you:Build custom applications that analyze trending stories or user interactions
you:Create educational tools demonstrating MCP integration with external APIs
you:What is the rate limiting for the Hacker News API?
you:Can I customize the number of stories/comments returned?

When to choose this

Choose this server when you need to integrate Hacker News data into AI workflows without complex setup, especially for prototyping or personal projects.

When NOT to choose this

Don't choose this for production systems as it lacks proper error handling, authentication, and has no rate limiting to protect against API throttling.

Tools this server exposes

4 tools extracted from the README
  • get-news

    Fetch top/new/best stories from Hacker News (returns first 10)

  • get-news-detail

    Fetch story metadata and first 10 comments

  • get-user-details

    Fetch user profile and recent activity

  • search-news

    Search Hacker News via Algolia and format results

Comparable tools

hn-mcpnews-mcp-serverweb-scraper-mcpcurl-mcp

Installation

# Clone the repository
git clone <repository-url>
cd hacker-mcp-server-POC

# Install dependencies
npm install

# Build TypeScript to JavaScript
npm run build

# Run the server
node build/index.js

For Claude Desktop, add to claude_desktop_config.json:

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

FAQ

What is the rate limiting for the Hacker News API?
The server doesn't implement explicit rate limiting, but the underlying Hacker News Firebase and Algolia APIs have their own limits. Consider adding your own rate limiting if you plan to make frequent requests.
Can I customize the number of stories/comments returned?
Currently, the server is configured to return the first 10 stories and comments. This could be modified by updating the helper functions in `src/helper.ts` to accept a limit parameter.

Compare hacker-mcp-server-POC with

hacker-mcp-server-POC vs ultimate_mcp_serverhacker-mcp-server-POC vs mcp-server-charthacker-mcp-server-POC vs everythinghacker-mcp-server-POC vs filesystemhacker-mcp-server-POC vs time
GitHub →

Last updated · Auto-generated from public README + GitHub signals.