mcp-hacker-news

The mcp-hacker-news server bridges Hacker News data with tools that support the Model Context Protocol (MCP). It exposes Hacker News data (top, new, and best stories, along with items and user profiles) through MCP endpoints so AI tools like Claude and Cursor can query live information in a structured, consistent way. The server additionally offers a set of tools for parameterized queries (e.g., fetching top stories with a custom limit, retrieving specific items or users, and fetching recent updates), enabling rich, context-aware interactions with the Hacker News ecosystem.

To use it with Claude Desktop or Cursor, configure your MCP client to point to the server. The README example shows wiring via an MCP config where the server is named mcp-hacker-news and launched through npx. Once running, your MCP-enabled assistant can request resources such as hackernews://top, hackernews://new, or hackernews://best, and can invoke tool-style actions like getTopStories(limit) or getItem(id) to fetch additional content on demand.

Prerequisites:

• Node.js version 18 or higher
• npm or pnpm as a package manager

Installation steps:

1. Clone the repository: git clone https://github.com/paablolc/mcp-hacker-news.git
2. Navigate to the project directory: cd mcp-hacker-news
3. Install dependencies (pnpm recommended): pnpm install
4. Build the project (if applicable): pnpm build
5. Run tests or start the MCP server as described in the docs (e.g., using the MCP Inspector if you want to test with the inspector tool): pnpm inspector or npx @modelcontextprotocol/inspector node dist/index.js

Note: If you don’t have pnpm, you can substitute npm install and npm run build where appropriate. The npm package name to run with npx is mcp-hacker-news, as shown in the configuration example.

Tips and common considerations:

• Ensure Node.js v18+ is installed and available in your PATH (node --version).
• The server relies on the public Hacker News API; consider rate limits and network access when deployed.
• The MCP endpoints exposed by this server align with the MCP spec, enabling integration with Claude, Cursor, and other MCP-enabled tools.
• To test locally, you can use the MCP Inspector tooling as shown in the README snippets.
• If you prefer npm over pnpm, you can adapt the commands accordingly (e.g., npm install, npm run build).
• The included tools (e.g., getTopStories, getItem, getUser) support customizable parameters; consult the project code or inline docs for exact argument shapes.