@microagents/server-hackernews/README.md

MCP server for Hacker News API integration

# Hacker News MCP Server

An MCP server implementation that enables Claude to interact with Hacker News content through the official and Algolia APIs.

## Installation

```bash
npm install @microagents/server-hackernews
# or
yarn add @microagents/server-hackernews
```

## Usage

### Direct Execution

```bash
# No environment variables needed
npx @microagents/server-hackernews
```

### With Claude Desktop

Add this to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "hackernews": {
      "command": "npx",
      "args": ["@microagents/server-hackernews"]
    }
  }
}
```

## Features

* **Search**: Search stories and comments using Algolia's HN Search API
* **Story Retrieval**: Get stories by type (top, new, best, ask, show, job)
* **Comment Threads**: Get a story with its full comment thread
* **User Profiles**: Get user information and submission history

## Tools

### search

Search stories and comments using Algolia's HN Search API.

**Inputs:**
- `query` (string): Search terms
- `type` (string, optional): Type of content to search ("story", "comment", or "all")
- `sortBy` (string, optional): Sort method ("relevance", "date", "points", or "comments")
- `page` (number, optional): Page number for pagination

### getStories

Get stories by type.

**Inputs:**
- `type` (string): Type of stories to retrieve ("top", "new", "best", "ask", "show", "job")
- `limit` (number, optional): Number of stories to retrieve (max 500)

### getStoryWithComments

Get a story with its comment thread.

**Inputs:**
- `id` (number): ID of the story

### getCommentTree

Get the full comment tree for a story.

**Inputs:**
- `id` (number): ID of the story

### getUser

Get user profile information.

**Inputs:**
- `username` (string): Username to retrieve

### getUserSubmissions

Get user's submissions (stories and comments).

**Inputs:**
- `username` (string): Username to retrieve submissions for
- `limit` (number, optional): Number of submissions to retrieve

## License

MIT

## Credits

Based on the original MCP server by [Abdul Rahman](https://github.com/devabdultech/hn-mcp).