A Model Context Protocol (MCP) server that provides access to Hacker News stories, comments, and user data, with support for search and content retrieval.
6.7K
4 Tools
Version 4.43 or later needs to be installed to add the server automatically
Use cases
About
A Model Context Protocol (MCP) server that provides access to Hacker News stories, comments, and user data, with support for search and content retrieval.
Attribute | Details |
---|---|
Docker Image | mcp/hackernews-mcp |
Author | AayushBahukhandi |
Repository | https://github.com/AayushBahukhandi/hackernews-mcp |
Dockerfile | https://github.com/AayushBahukhandi/hackernews-mcp/blob/main/Dockerfile |
Docker Image built by | Docker Inc. |
Docker Scout Health Score | |
Verify Signature | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/hackernews-mcp --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
Licence |
Tools provided by this Server | Short Description |
---|---|
get_stories | Get stories from Hacker News. |
get_story_info | Get detailed story info from Hacker News, including the comments |
get_user_info | Get user info from Hacker News, including the stories they've submitted |
search_stories | Search stories from Hacker News. |
get_stories
Get stories from Hacker News. The options are top
, new
, ask_hn
, show_hn
for types of stories. This doesn't include the comments. Use get_story_info
to get the comments.
Parameters | Type | Description |
---|---|---|
num_stories | integer optional | Number of stories to get |
story_type | string optional | Type of stories to get, one of: top , new , ask_hn , show_hn |
get_story_info
Get detailed story info from Hacker News, including the comments
Parameters | Type | Description |
---|---|---|
story_id | integer | Story ID |
get_user_info
Get user info from Hacker News, including the stories they've submitted
Parameters | Type | Description |
---|---|---|
user_name | string | Username of the user |
num_stories | integer optional | Number of stories to get, defaults to 10 |
search_stories
Search stories from Hacker News. It is generally recommended to use simpler queries to get a broader set of results (less than 5 words). Very targeted queries may not return any results.
Parameters | Type | Description |
---|---|---|
query | string | Search query |
num_results | integer optional | Number of results to get |
search_by_date | boolean optional | Search by date, defaults to false. If this is false, then we search by relevance, then points, then number of comments. |
{
"mcpServers": {
"mcp-hackernews": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"mcp/hackernews-mcp"
]
}
}
}
Manual installation
You can install the MCP server using:
Installation for