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

Related MCP server: Hacker News MCP Server

Instalación

1. Clonar el repositorio:

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

2. Instalar dependencias:

npm install

3. Construir el servidor:

npm run build

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

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.