MCP Claude Hackernews

🚀 MCP Claude and Hacker News Integration Guide

This guide provides detailed instructions on how to integrate and utilize data from Hacker News within MCP (Model Context Protocol) Claude. By following this guide, you'll be able to access, query, and analyze the latest stories, popular content, and comments on the Hacker News platform directly from Claude Desktop.

🚀 Quick Start

This guide will lead you through the steps of integrating Hacker News data into MCP Claude, allowing you to access and analyze Hacker News content from Claude Desktop.

✨ Features

• Access, query, and analyze Hacker News data from Claude Desktop.
• Support for natural - language queries.

📦 Installation

1. Download the MCP Library

Run the following command in your terminal to download and install the MCP library:

npm install mcp-claudie

2. Install Dependencies

Make sure you have Node.js and npm installed. Then, run the following command to install the necessary dependencies:

npm install hacker-news-api

3. Initialize the MCP Project

Create a mcp-config.json file in your project directory and add the following content:

{
  "services": {
    "hacker-news": {
      "type": "api",
      "endpoint": "https://hn.algolia.com/api/v1"
    }
  },
  "scripts": {
    "start": "node index.js"
  }
}

4. Create a Startup Script

Create the corresponding startup script based on your operating system:

Windows:

Create a new shortcut in C:\Users\%username%\AppData\Roaming\Microsoft\Windows\Start Menu. Set the target location to:

node.exe C:\path\to\your\project\index.js

macOS/Linux:

Create an executable file named mcp-hackernews in the /usr/local/bin directory and add the following content:

#!/bin/bash
cd /path/to/your/project && node index.js

Ensure the file has executable permissions:

chmod +x /usr/local/bin/mcp-hackernews

📚 Documentation

Configuration Guide

1. Create a Configuration File

Create a config.json file in the project root directory and add the following content:

{
  "api_key": "your_hacker_news_api_key",
  "max_results": 50,
  "default_category": "programming"
}

2. Modify the Configuration File

Modify the configuration file according to your needs. For example, if you want to limit the maximum number of results per query, you can adjust the value of max_results.

Usage Guide

1. Start the MCP Service

Run the following command in the terminal to start the MCP service:

npm start

2. Query Hacker News Data

Query Hacker News data from Claude Desktop using the following commands:

Get the latest stories:

hn latest --50

Get the top stories:

hn top --20

Get the best stories:

hn best --30

Get detailed information about a specific story:

hn history --12345678

Get comments:

hn comments --3 or hn comments --12345678

3. Use Natural Language Queries

You can also interact with MCP using natural language. For example:

• "Show the top 30 best stories on Hacker News today."
• "List the latest news in the programming category."

Troubleshooting

1. Ensure the API Key is Valid

Check your config.json file to make sure the api_key is valid. You can obtain the API key from the Hacker News API documentation.

2. Check the Network Connection

If you can't connect to the Hacker News service, ensure your device is connected to the internet and that the firewall isn't blocking the relevant ports.

3. View Error Logs

View the MCP output logs in the terminal to get more detailed information about the problem:

npm run debug

Contribution Guide

1. Submit Code

You can contribute code to this project by submitting a pull request. Make sure your code adheres to the project's coding standards.

2. Create Feature Requests

If you have any feature requirements or improvement suggestions, create a new issue in the GitHub repository.

📄 License

This project is licensed under the MIT License. You can find the full license information in the LICENSE file.