HackerNews MCP Server

hn-mcp-server

npm version License: MIT Node.js Version TypeScript Coverage MCP

A Model Context Protocol server that provides AI assistants with structured access to HackerNews content via the Algolia API.

Features

✅ Search Posts - Search HackerNews for stories, comments, and discussions by keyword
✅ Front Page - Get currently trending HackerNews posts
✅ Latest Posts - Monitor newest content sorted by date
✅ Item Details - Retrieve complete posts with nested comment trees
✅ User Profiles - View author information, karma, and bios

Prerequisites

Node.js 18.0.0 or higher
npm 9.0.0 or higher
MCP Client - Claude Desktop, Continue.dev, or any MCP-compatible client

Installation

From npm (Coming Soon)

npm install -g hn-mcp-server

From Source

# Clone the repository git clone https://github.com/yourusername/hn-mcp-server.git cd hn-mcp-server # Install dependencies npm install # Build the project npm run build # Link globally (optional) npm link

Configuration

For Claude Desktop

Add to your Claude Desktop configuration file:

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

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

Or if installed globally:

{ "mcpServers": { "hackernews": { "command": "hn-mcp-server" } } }

Available Tools

1. search-posts

Search HackerNews by keyword with optional filters.

{ query: "AI", tags: ["story"], numericFilters: ["points>=100"], page: 0, hitsPerPage: 20 }

2. get-front-page

Get current HackerNews front page posts.

{ page: 0, hitsPerPage: 30 }

3. get-latest-posts

Get most recent posts sorted by date.

{ tags: ["story"], page: 0, hitsPerPage: 20 }

4. get-item

Retrieve complete item details with nested comments.

{ itemId: "38456789" }

5. get-user

Get user profile information.

{ username: "pg" }

Development

Install Dependencies

npm install

Build

npm run build # Build once npm run build:watch # Build and watch for changes npm run clean # Clean build output

Testing

npm test # Run tests npm run test:coverage # Run tests with coverage npm run test:ui # Run tests with UI

Linting & Formatting

npm run lint # Check code quality npm run lint:fix # Fix linting issues npm run format # Format code npm run format:check # Check formatting

Documentation

API Reference - Detailed API documentation
Architecture - System design and architecture
Contributing - How to contribute
Quick Start - Quick start guide

Examples

See the Quick Start Guide for comprehensive usage examples.

License

MIT License - See LICENSE for details

Resources

HackerNews API: https://hn.algolia.com/api
MCP Documentation: https://modelcontextprotocol.io
GitHub Repository: https://github.com/yourusername/hn-mcp-server
Report Issues: https://github.com/yourusername/hn-mcp-server/issues

Deploy Server

HTTP connection URL

-

security - not tested

A

license - permissive license

-

quality - not tested

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

Enables AI assistants to access HackerNews content through structured search, front page retrieval, latest posts monitoring, detailed item fetching with comment trees, and user profile viewing via the Algolia API.