Skip to main content
Glama

Hacker News MCP Server

by GeorgeNance
npmGitHub
JavaScript
MIT License
51
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

📰 Hacker News MCP Server

A Model Context Protocol (MCP) server that provides tools to fetch and interact with Hacker News content. This server enables AI assistants to access real-time Hacker News data including top stories, story details, comments, and search functionality.

🚀 Features

🛠️ Available Tools

  • get_top_stories - Fetch the latest top stories from Hacker News
    • Configurable count (1-100 stories)
    • Optional text content inclusion
    • Returns story metadata including title, URL, score, author, and comment count
  • get_story_details - Get detailed information about a specific story
    • Fetch complete story metadata
    • Optional comment inclusion with threaded structure
    • Optional markdown content extraction from linked articles
  • get_story_comments - Retrieve popular comments for a story
    • Configurable minimum score filtering
    • Adjustable comment thread depth (1-10 levels)
    • Limit number of comments returned (1-100)
    • Formatted as readable text with thread structure
  • search_stories - Search recent stories by keywords
    • Search through story titles, content, and URLs
    • Configurable time range (1-168 hours)
    • Limit results (1-50 stories)

📋 Prerequisites

  • Node.js 18+
  • npm or yarn
  • An MCP-compatible client (like Claude Desktop)

🔧 Installation

1. Clone the repository

git clone https://github.com/yourusername/hackernews-mcp.git cd hackernews-mcp

2. Install dependencies

npm install

3. Build the server

npm run build

🎯 Usage

With Claude Desktop

Add the server to your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

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

With Other MCP Clients

The server communicates via stdio and can be used with any MCP-compatible client:

node build/index.js

🔍 Example Usage

Once connected, you can ask your AI assistant things like:

  • "What are the top stories on Hacker News today?"
  • "Get details about Hacker News story 12345678"
  • "Show me comments for that viral AI story"
  • "Search for recent stories about TypeScript"

🛠️ Development

Build the project

npm run build

Watch mode for development

npm run watch

Lint and format the code

npm run lint npm run format

Run the MCP Inspector

For debugging and testing:

npm run inspector

This will start the MCP Inspector, providing a web interface to test the server's tools and inspect the communication.

📦 Code Quality & Contributing

  • Code Quality:
    This project enforces code quality and style using ESLint and Prettier. All code is checked in CI (GitHub Actions) and must pass linting and formatting before merging.
  • Type Safety:
    All tool handlers use explicit type guards for runtime argument validation and robust TypeScript types.
  • CI/CD:
    Every push and pull request runs the full build, lint, and (future) test suite via GitHub Actions.
  • How to Contribute:
    1. Fork the repository
    2. Create a feature branch (git checkout -b feature/amazing-feature)
    3. Commit your changes (git commit -m 'Add amazing feature')
    4. Run npm run lint and npm run format before pushing
    5. Push to the branch (git push origin feature/amazing-feature)
    6. Open a Pull Request

📚 API Reference

get_top_stories

{ count?: number; // Number of stories (1-100, default: 30) include_text?: boolean; // Include story text content (default: false) }

get_story_details

{ story_id: number; // Required: HN story ID include_comments?: boolean; // Include comments (default: false) include_markdown?: boolean; // Extract article as markdown (default: false) }

get_story_comments

{ story_id: number; // Required: HN story ID min_score?: number; // Minimum comment score (default: 1) max_depth?: number; // Max thread depth (1-10, default: 3) limit?: number; // Max comments (1-100, default: 20) }

search_stories

{ query: string; // Required: Search keywords limit?: number; // Max results (1-50, default: 20) time_range_hours?: number; // Hours to search back (1-168, default: 24) }

🏗️ Architecture

The server is built with:

  • TypeScript for type safety and developer experience
  • @modelcontextprotocol/sdk for MCP protocol implementation
  • axios for HTTP requests to Hacker News API
  • jsdom and turndown for HTML to Markdown conversion
  • private-ip for security (blocks private IP access)

Key Components

  • src/index.ts - Main server implementation with tool handlers
  • src/fetcher.ts - Utility class for fetching and converting web content
  • build/ - Compiled JavaScript output (auto-generated)

🔒 Security

  • Blocks requests to private IP addresses to prevent local network access
  • Rate limiting through Hacker News API natural limits
  • Input validation for all tool parameters
  • Error handling and graceful degradation

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

📞 Support

If you encounter any issues or have questions:

  1. Check the Issues page
  2. Use the MCP Inspector for debugging: npm run inspector
  3. Create a new issue with detailed information about your problem

Made with ❤️ for the MCP community

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

An MCP server that enables AI assistants to access real-time Hacker News data including top stories, story details, comments, and search functionality.

  1. 🚀 Features
    1. 🛠️ Available Tools
  2. 📋 Prerequisites
    1. 🔧 Installation
      1. Clone the repository
      2. Install dependencies
      3. Build the server
    2. 🎯 Usage
      1. With Claude Desktop
      2. With Other MCP Clients
    3. 🔍 Example Usage
      1. 🛠️ Development
        1. Build the project
        2. Watch mode for development
        3. Lint and format the code
        4. Run the MCP Inspector
      2. 📦 Code Quality & Contributing
        1. 📚 API Reference
          1. get_top_stories
          2. get_story_details
          3. get_story_comments
          4. search_stories
        2. 🏗️ Architecture
          1. Key Components
        3. 🔒 Security
          1. 📜 License
            1. 🙏 Acknowledgments
              1. 📞 Support

                Related Resources

                Related MCP Servers

                • mcp-hn

                  erithwik
                  A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol (MCP) server that provides tools for searching and fetching information from Hacker News.
                  Last updated -
                  4
                  6
                  Python
                  MIT License
                  • Apple

                • Scrapling Fetch MCP

                  cyberchitta
                  -
                  security
                  A
                  license
                  -
                  quality
                  An MCP server that helps AI assistants access text content from websites that implement bot detection, bridging the gap between what you can see in your browser and what the AI can access.
                  Last updated -
                  1
                  Python
                  Apache 2.0

                • crypto-news-mcp

                  kukapay
                  -
                  security
                  A
                  license
                  -
                  quality
                  An MCP server that provides real-time cryptocurrency news sourced from NewsData for AI agents.
                  Last updated -
                  3
                  Python
                  MIT License

                • HackathonWatch MCP Server

                  ag2-mcp-servers
                  -
                  security
                  F
                  license
                  -
                  quality
                  An MCP server for interacting with the HackathonWatch API, allowing users to access hackathon data and related information through natural language commands.
                  Last updated -
                  Python
                  • Linux
                  • Apple

                View all related MCP servers

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/GeorgeNance/hackernews-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server