Hacker News Mcp Serveur

Qu'est-ce que hn-server ?

Le ### hn-server est un dépôt public créé par l'utilisateur ### pskill9 sur GitHub. Il sert d'implémentation serveur pour Hacker News, un site web de nouvelles sociales populaire qui se concentre sur l'informatique et l'entrepreneuriat. Ce projet permet aux utilisateurs d'interagir avec Hacker News via une application côté serveur, offrant des fonctionnalités telles que la récupération d'articles de nouvelles, la soumission d'histoires et les commentaires, tout en respectant l'API de Hacker News.

Caractéristiques de hn-server

• Accès Public : Le dépôt est ouvert au public, permettant à quiconque de voir, de forker ou de contribuer au projet.
• Licence MIT : Le projet est sous licence MIT, ce qui permet aux utilisateurs d'utiliser, de copier, de modifier et de distribuer le logiciel.
• Communauté Active : Le dépôt a attiré l'attention avec 35 étoiles et 8 forks, indiquant un intérêt croissant et une implication de la communauté.
• Intégration Facile : Le serveur peut être facilement intégré à diverses applications, offrant une expérience fluide pour les développeurs souhaitant utiliser les données de Hacker News.
• Documentation : Une documentation complète est disponible pour aider les utilisateurs à comprendre comment configurer et utiliser le serveur efficacement.

Comment utiliser hn-server

1. Cloner le Dépôt : Commencez par cloner le dépôt hn-server sur votre machine locale en utilisant la commande :

   git clone https://github.com/pskill9/hn-server.git
   

2. Installer les Dépendances : Naviguez jusqu'au répertoire du projet et installez les dépendances nécessaires. Cela peut généralement être fait en utilisant un gestionnaire de paquets comme npm ou yarn, selon la configuration du projet.

3. Exécuter le Serveur : Après avoir installé les dépendances, vous pouvez exécuter le serveur en utilisant la commande spécifiée dans la documentation (généralement quelque chose comme npm start).

4. Interagir avec l'API : Une fois le serveur en cours d'exécution, vous pouvez interagir avec les points de terminaison de l'API de Hacker News pour récupérer des articles de nouvelles, soumettre des histoires, et plus encore.

5. Contribuer : Si vous souhaitez contribuer au projet, n'hésitez pas à forker le dépôt, à apporter vos modifications et à soumettre une demande de tirage.

Questions Fréquemment Posées

Quelles technologies sont utilisées dans hn-server ?

hn-server est généralement construit en utilisant JavaScript et Node.js, tirant parti de diverses bibliothèques et frameworks pour faciliter les opérations côté serveur.

Puis-je contribuer au projet hn-server ?

Oui ! Les contributions sont les bienvenues. Vous pouvez forker le dépôt, apporter des modifications et soumettre une demande de tirage pour révision.

Y a-t-il un moyen d'exécuter hn-server localement ?

Absolument ! Vous pouvez cloner le dépôt et suivre les instructions de configuration dans la documentation pour l'exécuter sur votre machine locale.

Quel est le but de la licence MIT ?

La licence MIT permet aux utilisateurs d'utiliser, de modifier et de distribuer librement le logiciel, favorisant la collaboration et l'innovation en open source.

Comment puis-je signaler des problèmes ou des bogues ?

Vous pouvez signaler des problèmes en naviguant vers l'onglet "Issues" dans le dépôt GitHub de hn-server et en soumettant un nouveau problème avec des détails sur le problème que vous rencontrez.

Hacker News MCP Server

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).

<a href="https://glama.ai/mcp/servers/oge85xl22f"><img width="380" height="200" src="https://glama.ai/mcp/servers/oge85xl22f/badge" alt="Hacker News MCP server" /></a>

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:

git clone https://github.com/pskill9/hn-server
cd hn-server

2. Install dependencies:

npm install

3. Build the server:

npm run build

4. Add to your MCP settings configuration file (location depends on your system):

For VSCode Claude extension:

{
  "mcpServers": {
    "hacker-news": {
      "command": "node",
      "args": ["/path/to/hn-server/build/index.js"]
    }
  }
}

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:

use_mcp_tool with:
server_name: "hacker-news"
tool_name: "get_stories"
arguments: {
  "type": "top",
  "limit": 5
}

Sample output:

[
  {
    "title": "Example Story Title",
    "url": "https://example.com/story",
    "points": 100,
    "author": "username",
    "time": "2024-12-28T00:03:05",
    "commentCount": 50,
    "rank": 1
  },
  // ... more stories
]

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:

// ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
// %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
  "mcpServers": {
    "hacker-news": {
      "command": "node",
      "args": ["/path/to/hn-server/build/index.js"]
    }
  }
}

For the VSCode Claude extension, add to:

// VSCode Settings JSON
{
  "mcpServers": {
    "hacker-news": {
      "command": "node",
      "args": ["/path/to/hn-server/build/index.js"]
    }
  }
}

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
• Cheerio for HTML parsing

To modify the server:

1. Make changes to src/index.ts
2. Rebuild:

npm run build

Error Handling

The server includes robust error handling for:

• Invalid story types
• Network failures
• HTML parsing errors
• Invalid parameter values

Errors are returned with appropriate error codes and descriptive messages.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - feel free to use this in your own projects.