mcp-claude-hackernews

Noticias de hackers de MCP Claude

Características

Explora las últimas noticias de Hacker News
Ver las historias más populares y mejor valoradas
Obtenga detalles de la historia
Leer comentarios de las historias
Formato limpio del contenido de Hacker News para una mejor legibilidad

Manifestación

Requisitos

Node.js 16 o superior
Escritorio de Claude
Conexión a Internet para acceder a la API de Hacker News

Instalación

Instalación manual

Clonar o descargar este repositorio:

git clone https://github.com/imprvhub/mcp-claude-hackernews
cd mcp-claude-hackernews

Instalar dependencias:

npm install

Construir el proyecto:

npm run build

Ejecución del servidor MCP

Hay dos formas de ejecutar el servidor MCP:

Opción 1: Ejecutar manualmente

Abra una terminal o un símbolo del sistema
Navegar al directorio del proyecto
Ejecute el servidor directamente:

node build/index.js

Mantenga esta ventana de terminal abierta mientras usa Claude Desktop. El servidor se ejecutará hasta que cierre la terminal.

Opción 2: Inicio automático con Claude Desktop (recomendado para uso habitual)

El Escritorio Claude puede iniciar automáticamente el servidor MCP cuando sea necesario. Para configurarlo:

Configuración

El archivo de configuración de Claude Desktop se encuentra en:

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Ventanas : %APPDATA%\Claude\claude_desktop_config.json
Linux : ~/.config/Claude/claude_desktop_config.json

Edite este archivo para agregar la configuración del MCP de Hacker News. Si el archivo no existe, créelo:

{
  "mcpServers": {
    "hackerNews": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_DIRECTORY/mcp-claude-hackernews/build/index.js"]
    }
  }
}

Importante : Reemplace ABSOLUTE_PATH_TO_DIRECTORY con la ruta absoluta completa donde instaló el MCP

Ejemplo para macOS/Linux: /Users/username/mcp-claude-hackernews
Ejemplo de Windows: C:\\Users\\username\\mcp-claude-hackernews

Si ya tiene otros MCP configurados, simplemente añada la sección "hackerNews" dentro del objeto "mcpServers". A continuación, se muestra un ejemplo de configuración con varios MCP:

{
  "mcpServers": {
    "otherMcp1": {
      "command": "...",
      "args": ["..."]
    },
    "otherMcp2": {
      "command": "...",
      "args": ["..."]
    },
    "hackerNews": {
      "command": "node",
      "args": [
        "ABSOLUTE_PATH_TO_DIRECTORY/mcp-claude-hackernews/build/index.js"
      ]
    }
  }
}

El servidor MCP se iniciará automáticamente cuando Claude Desktop lo necesite, según la configuración de su archivo claude_desktop_config.json .

Uso

Reinicie Claude Desktop después de modificar la configuración
En Claude, usa el comando hn para interactuar con Hacker News
El servidor MCP se ejecuta como un proceso secundario administrado por Claude Desktop

Comandos disponibles

El MCP de Hacker News proporciona una única herramienta llamada hn con varios comandos:

Dominio	Descripción	Parámetros	Ejemplo
`latest`	Obtenga las historias más recientes de Hacker News	`param` : Número opcional de historias (predeterminado: 10, máximo: 50)	`hn latest --50`
`top`	Obtenga las principales noticias de Hacker News	`param` : Número opcional de historias (predeterminado: 10, máximo: 50)	`hn top --20`
`best`	Obtenga las mejores historias de Hacker News	`param` : Número opcional de historias (predeterminado: 10, máximo: 50)	`hn best --30`
`history`	Obtenga información detallada sobre una historia específica	`param` : ID de historia requerida	`hn history --12345678`
`comments`	Obtener comentarios para una historia	`param` : Índice requerido de la última lista o ID de historia	`hn comments --3` o `hn comments --12345678`

Ejemplo de uso

A continuación se muestran varios ejemplos de cómo utilizar el MCP de Hacker News con Claude:

Comandos directos:

hn latest --50
hn top --20
hn best --30
hn history --29384756
hn comments --5

Consultas en lenguaje natural:

También puedes interactuar con el MCP mediante lenguaje natural. Claude interpretará estas solicitudes y usará los comandos adecuados:

Muéstrame las 30 noticias más importantes de Hacker News hoy.
"¿Cuáles son las 40 últimas publicaciones en Hacker News?"
Me gustaría ver los 20 mejores artículos de Hacker News.
"¿Puedes traerme 30 noticias tecnológicas recientes de Hacker News?"
Dime cuáles son los 50 temas más populares en Hacker News.
Muéstrame 20 artículos de Hacker News sobre aprendizaje automático.
"Consígueme los 40 titulares más recientes de Hacker News"
¿Cuáles son las 30 discusiones más activas en Hacker News en este momento?
Me interesa leer los 40 artículos más populares de Hacker News de esta semana.
"Muéstrame una lista de los 20 mejores artículos de programación de Hacker News"

Solicitudes de traducción de idiomas:

Puedes solicitar que el contenido de Hacker News se traduzca a diferentes idiomas:

Muéstrame las 30 noticias más importantes de Hacker News hoy en español.
Obtén las 20 últimas publicaciones de Hacker News y tradúcelas al francés.
Me gustaría ver los 40 mejores artículos de Hacker News en alemán.
Muéstrame 30 noticias recientes de Hacker News traducidas al japonés.
Obtén los 20 mejores artículos de Hacker News y preséntalos en portugués.

Solución de problemas

Error "Servidor desconectado"

Si ves el error "MCP Hacker News: Servidor desconectado" en Claude Desktop:

Verifique que el servidor esté ejecutándose :
- Abra una terminal y ejecute manualmente node build/index.js desde el directorio del proyecto
- Si el servidor se inicia correctamente, utilice Claude mientras mantiene esta terminal abierta
Comprueba tu configuración :
- Asegúrese de que la ruta absoluta en claude_desktop_config.json sea correcta para su sistema
- Verifique nuevamente que haya utilizado barras invertidas dobles ( \\ ) para las rutas de Windows
- Verifique que esté utilizando la ruta completa desde la raíz de su sistema de archivos
Pruebe la opción de inicio automático :
- Configure el script de inicio automático para su sistema operativo como se describe en la sección "Configuración de scripts de inicio automático".
- Esto garantiza que el servidor siempre esté funcionando cuando lo necesite.

Herramientas que no aparecen en Claude

Si las herramientas de Hacker News no aparecen en Claude:

Asegúrese de haber reiniciado Claude Desktop después de la configuración
Verifique los registros de Claude Desktop para detectar cualquier error de comunicación de MCP
Asegúrese de que el proceso del servidor MCP se esté ejecutando (ejecútelo manualmente para confirmarlo)
Verifique que el servidor MCP esté registrado correctamente en el registro de MCP de Claude Desktop

Comprobando si el servidor está funcionando

Para comprobar si el servidor está funcionando:

Windows : Abra el Administrador de tareas, vaya a la pestaña "Detalles" y busque "node.exe"
macOS/Linux : Abra la Terminal y ejecute ps aux | grep node

Si no ve el servidor en ejecución, inícielo manualmente o utilice el método de inicio automático.

Contribuyendo

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

Licencia

Este proyecto está licenciado bajo la Licencia Pública de Mozilla 2.0: consulte el archivo de LICENCIA para obtener más detalles.