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.

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

Clonar el repositorio:

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

Instalar dependencias:

npm install

Construir el servidor:

npm run build

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:

Tenga instalada la aplicación de escritorio Claude o la extensión VSCode Claude
Configurar el servidor MCP en su configuración
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.

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:

Realizar cambios en src/index.ts
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.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

get_stories

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

Related Resources

Reddit Discussion about this server

Hacker News MCP