Skip to main content

Hacker News MCP Server

A Model Context Protocol (MCP) server that provides tools for fetching information from Hacker News.

Tools

  • get_stories Fetching (top, new, ask_hn, show_hn) stories
  • get_story_info Fetching comments associated with a story
  • search_stories Searching for stories by query
  • get_user_info Fetching user info

Example Usage

Use prompts like the following:

- Get the top stories of today (will use `get_stories` tool`)
- What does the details of the story today that talks about the future of AI (will use `get_story_info` tool` based on the results of the previous tool)
- What has the user `pg` been up to? (will use `get_user_info` tool)
- What does hackernews say about careers in AI? (will use `search_stories` tool)

Quickstart

Claude Desktop:

Update the following:

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

With the following for development:

{
  "mcpServers": {
    "mcp-hn": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/mcp-hn",
        "run",
        "mcp-hn"
      ]
    }
  }
}

Or with the following for production:

{
  "mcpServers": {
    "mcp-hn": {
      "command": "uvx",
      "args": ["mcp-hn"]
    }
  }
}

Release files for mcp-hn 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-hn 0.1.0
File Size Uploaded
mcp_hn-0.1.0.tar.gz 15.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-hn 0.1.0
File Interpreter ABI Platform
mcp_hn-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size:21.5 kB

Release files / mcp_hn-0.1.0.tar.gz

Download URL mcp_hn-0.1.0.tar.gz
Size 15.5 kB
Tags Source
SHA-256 checksum
How to use checksums
c3721b833b7fb217f2a6faf11244db79705e132dc26e1dd55ec1195041fac8e5
BLAKE2b-256 checksum
How to use checksums
eb53910b1163af786cb6280ae5eca466d28fea403633932d59b21d4d5b41fa5c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.13.1

Release files / mcp_hn-0.1.0-py3-none-any.whl

Download URL mcp_hn-0.1.0-py3-none-any.whl
Size 6.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6785943821104481d2b2ab5b22eb4b48fcb3eb236b4e0422690078e09c08de57
BLAKE2b-256 checksum
How to use checksums
09de39efda67b5a676869e09ed297e1db24ab2be69cba92ccd350446a0d2f53f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.13.1

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page