Skip to main content
Glama

Hacker News MCP

by pskill9

Servidor MCP de Hacker News

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para obtener noticias de Hacker News. Este servidor analiza el contenido HTML de news.ycombinator.com y proporciona datos estructurados para diferentes tipos de noticias (principales, nuevas, preguntas frecuentes, programas y empleos).

Características

  • Obtener diferentes tipos de historias (principales, nuevas, preguntas, mostrar, trabajos)
  • Obtenga datos estructurados que incluyan títulos, URL, puntos, autores, marcas de tiempo y recuentos de comentarios.
  • Límite configurable en el número de historias devueltas
  • Manejo limpio de errores y validación

Instalación

  1. Clonar el repositorio:
git clone https://github.com/pskill9/hn-server cd hn-server
  1. Instalar dependencias:
npm install
  1. Construir el servidor:
npm run build
  1. Agregue a su archivo de configuración de MCP (la ubicación depende de su sistema):

Para la extensión Claude de VSCode:

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

Uso

El servidor proporciona una herramienta llamada get_stories que puede utilizarse para obtener historias de Hacker News.

Herramienta: get_stories

Parámetros:

  • type (cadena): Tipo de historias a buscar
    • Opciones: 'top', 'nuevo', 'preguntar', 'mostrar', 'trabajos'
    • Predeterminado: 'arriba'
  • limit (número): Número de historias a devolver
    • Rango: 1-30
    • Predeterminado: 10

Ejemplo de uso:

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

Ejemplo de salida:

[ { "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 ]

Integración con Claude

Para utilizar este servidor MCP con Claude, necesitarás:

  1. Tenga instalada la aplicación de escritorio Claude o la extensión VSCode Claude
  2. Configurar el servidor MCP en su configuración
  3. Utilice la interfaz de lenguaje natural de Claude para interactuar con Hacker News

Configuración

Para la aplicación de escritorio Claude, agregue la configuración del servidor a:

// ~/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"] } } }

Para la extensión Claude de VSCode, agregue:

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

Ejemplos de interacciones

Una vez configurado, puedes interactuar con Claude usando lenguaje natural para obtener noticias de Hacker News. Ejemplos:

  • Muéstrame las 5 noticias más importantes de Hacker News.
  • "¿Cuáles son las últimas publicaciones de Ask HN?"
  • "Consígueme las mejores presentaciones de Show HN de hoy"

Claude utilizará automáticamente los parámetros apropiados para obtener las historias que desea.

Claude usando el servidor MCP de Hacker News

Estructura del objeto de la historia

Cada objeto de historia contiene:

  • title (cadena): el título de la historia
  • url (cadena, opcional): URL de la historia (puede ser la URL interna de HN para publicaciones de texto)
  • points (número): Número de votos positivos
  • author (cadena): nombre de usuario del autor
  • time (cadena): marca de tiempo de cuándo se publicó la historia
  • commentCount (número): Número de comentarios
  • rank (número): Posición en la lista

Desarrollo

El servidor está construido utilizando:

  • Mecanografiado
  • SDK de protocolo de contexto de modelo
  • Axios para solicitudes HTTP
  • ¡Adiós al análisis de HTML!

Para modificar el servidor:

  1. Realizar cambios en src/index.ts
  2. Reconstruir:
npm run build

Manejo de errores

El servidor incluye un manejo robusto de errores para:

  • Tipos de historias no válidos
  • Fallos de red
  • Errores de análisis de HTML
  • Valores de parámetros no válidos

Los errores se devuelven con códigos de error apropiados y mensajes descriptivos.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Licencia MIT: siéntete libre de usarla en tus propios proyectos.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Analiza el contenido HTML de news.ycombinator.com (Hacker News) y proporciona datos estructurados para diferentes tipos de historias (principales, nuevas, preguntas, programas, empleos).

  1. Características
    1. Instalación
      1. Uso
        1. Herramienta: get\_stories
      2. Integración con Claude
        1. Configuración
        2. Ejemplos de interacciones
        3. Estructura del objeto de la historia
      3. Desarrollo
        1. Manejo de errores
          1. Contribuyendo
            1. Licencia

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                Provides tools to fetch and search news from The Verge's RSS feed, allowing users to get today's news, retrieve random articles from the past week, and search for specific keywords in recent Verge content.
                Last updated -
                3
                1
                TypeScript
                MIT License
                • Apple
              • A
                security
                A
                license
                A
                quality
                Enables extracting data from websites using natural language prompts, allowing users to specify exactly what content they want in plain English and returning structured JSON data.
                Last updated -
                1
                1,379
                4
                TypeScript
                MIT License
                • Apple
                • Linux
              • A
                security
                A
                license
                A
                quality
                Adds powerful Hacker News integration to LLM clients, allowing users to access stories, comments, user profiles, and search functionality through the Model Context Protocol.
                Last updated -
                9
                25
                4
                JavaScript
                MIT License
              • -
                security
                F
                license
                -
                quality
                Provides functionality to fetch web content in various formats, including HTML, JSON, plain text, and Markdown.
                Last updated -
                125,855
                1

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/pskill9/hn-server'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server