Hacker News MCP

An MCP server that exposes Hacker News data as tools for AI agents. Built on Cloudflare Workers with the Agents SDK.

Data comes from the Hacker News Firebase API.

Tools

Related MCP server: hn-mcp

Setup

npm install

Development

npm run dev

Starts a local Worker with Wrangler. Point your MCP client at the local endpoint once it's running.

Deploy

npm run deploy

Deploys to Cloudflare Workers. After deploy, connect your MCP client to the Worker URL.

Project structure

src/
  main.ts              # MCP server entrypoint
  tools/               # Individual tool handlers
  utils/registerTools.ts
wrangler.jsonc         # Cloudflare Workers config

Contributing

1. Fork the repository and create a branch from main.

2. Install dependencies with npm install.

3. Make your changes and verify them locally with npm run dev.

4. Open a pull request describing what you changed and why.

Bug reports and feature ideas are welcome via GitHub Issues.