📇 ☁️ - Parse Hacker News pages into structured data for top, new, ask, show and job stories
Hacker News MCP Server
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
A Model Context Protocol (MCP) server that provides tools for fetching stories from Hacker News. This server parses the HTML content from news.ycombinator.com and provides structured data for different types of stories (top, new, ask, show, jobs).
Features
- Fetch different types of stories (top, new, ask, show, jobs)
- Get structured data including titles, URLs, points, authors, timestamps, and comment counts
- Configurable limit on number of stories returned
- Clean error handling and validation
Installation
1. Clone the repository:
2. Install dependencies:
3. Build the server:
4. Add to your MCP settings configuration file (location depends on your system):
For VSCode Claude extension:
Usage
The server provides a tool called get_stories that can be used to fetch stories from Hacker News.
Tool: get_stories
Parameters:
- type (string): Type of stories to fetch
- Options: 'top', 'new', 'ask', 'show', 'jobs'
- Default: 'top'
- limit (number): Number of stories to return
- Range: 1-30
- Default: 10
Example usage:
Sample output:
Integrating with Claude
To use this MCP server with Claude, you'll need to:
1. Have the Claude desktop app or VSCode Claude extension installed
2. Configure the MCP server in your settings
3. Use Claude's natural language interface to interact with Hacker News
Configuration
For the Claude desktop app, add the server configuration to:
For the VSCode Claude extension, add to:
Example Interactions
Once configured, you can interact with Claude using natural language to fetch Hacker News stories. Examples:
- "Show me the top 5 stories from Hacker News"
- "What are the latest Ask HN posts?"
- "Get me the top Show HN submissions from today"
Claude will automatically use the appropriate parameters to fetch the stories you want.
Story Object Structure
Each story object contains:
- title (string): The story title
- url (string, optional): URL of the story (may be internal HN URL for text posts)
- points (number): Number of upvotes
- author (string): Username of the poster
- time (string): Timestamp of when the story was posted
- commentCount (number): Number of comments
- rank (number): Position in the list
Development
The server is built using:
- TypeScript
- Model Context Protocol SDK
- Axios for HTTP requests