MCP Claude Hacker News

Interactúa con Hacker News a través del Protocolo de Contexto de Modelo (MCP), diseñado para Claude Desktop.

Documentación

MCP Claude Hacker News

Una integración que permite a Claude Desktop interactuar con Hacker News utilizando el Protocolo de Contexto de Modelo (MCP).

Características

Explorar las historias más recientes de Hacker News
Ver historias mejor valoradas y más populares
Buscar historias por palabra clave, por relevancia o más recientes (API de búsqueda de Algolia HN)
Obtener detalles de historias
Leer comentarios de historias, limitados para que un hilo muy activo no inunde el contexto
Formato limpio del contenido de Hacker News para una mejor legibilidad, incluida la decodificación de entidades HTML

Demo

Requisitos

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

Instalación

Instalación mediante Smithery

Instale el paquete empaquetado desde la página del servidor de Smithery, o desde la CLI:

npx -y @smithery/cli@latest mcp add imprvhub/mcp-claude-hackernews --client claude

Instalación manual

Clone o descargue este repositorio:

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

Instale las dependencias:

npm install

Compile el proyecto:

npm run build

Ejecución del servidor MCP

Hay dos formas de ejecutar el servidor MCP:

Opción 1: Ejecución manual

Abra una terminal o símbolo del sistema
Navegue 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 regular)

Claude Desktop 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
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Edite este archivo para agregar la configuración 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 macOS/Linux: /Users/username/mcp-claude-hackernews
Ejemplo Windows: C:\\Users\\username\\mcp-claude-hackernews

Si ya tiene otros MCP configurados, simplemente agregue la sección "hackerNews" dentro del objeto "mcpServers". Aquí hay un ejemplo de una configuración con múltiples 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 en su archivo claude_desktop_config.json.

Uso

Reinicie Claude Desktop después de modificar la configuración
En Claude, use las herramientas de Hacker News para interactuar con Hacker News
El servidor MCP se ejecuta como un proceso hijo administrado por Claude Desktop

Herramientas disponibles

El MCP de Hacker News proporciona 6 herramientas especializadas para diferentes funciones:

Herramienta	Descripción	Parámetros	Ejemplo de uso
`hn_latest`	Obtener las historias más recientes de Hacker News	`limit`: Número opcional de historias (1-50, predeterminado: 10)	Obtener las 20 historias más recientes
`hn_top`	Obtener las historias mejor valoradas de Hacker News	`limit`: Número opcional de historias (1-50, predeterminado: 10)	Obtener las 15 historias principales
`hn_best`	Obtener las mejores historias de Hacker News	`limit`: Número opcional de historias (1-50, predeterminado: 10)	Obtener las 25 mejores historias
`hn_search`	Buscar historias por palabra clave	`query`: Términos de búsqueda obligatorios; `limit`: 1-50 (predeterminado: 10); `sort`: `relevance` (predeterminado) o `date`	Buscar "rust async" ordenado por fecha
`hn_story`	Obtener información detallada sobre una historia específica	`story_id`: ID de historia obligatorio (número)	Obtener detalles de la historia por ID
`hn_comments`	Obtener comentarios de nivel superior para una historia	`story_id`: ID de historia (número) O `story_index`: Índice de la última lista (basado en 1); `limit`: 1-50 (predeterminado: 20)	Obtener comentarios por ID de historia o índice

Detalles de los parámetros de las herramientas

`hn_latest`, `hn_top`, `hn_best`

limit (opcional): Número de historias a obtener
- Tipo: Número
- Rango: 1-50
- Predeterminado: 10

`hn_search`

query (obligatorio): Términos de búsqueda
- Tipo: Cadena
- Ejemplo: "model context protocol"
limit (opcional): Número de resultados, 1-50, predeterminado 10
sort (opcional): relevance (predeterminado) o date para los más recientes primero

`hn_story`

story_id (obligatorio): El ID de la historia a obtener
- Tipo: Número
- Ejemplo: 12345678

`hn_comments`

story_id (opcional): El ID de la historia para obtener comentarios
- Tipo: Número
- Ejemplo: 12345678
story_index (opcional): El índice de la historia de la última lista obtenida
- Tipo: Número (basado en 1)
- Ejemplo: 3 (para la tercera historia de la última lista)
limit (opcional): Número máximo de comentarios de nivel superior a devolver
- Tipo: Número
- Rango: 1-50
- Predeterminado: 20

Nota: Para hn_comments, debe proporcionar story_id O story_index. Solo se obtienen comentarios de nivel superior; el número de respuestas se informa por comentario. La respuesta indica cuántos comentarios de nivel superior del hilo se devolvieron.

Ejemplos de uso

Aquí hay varios ejemplos de cómo usar el MCP de Hacker News con Claude:

Uso directo de herramientas:

"Use hn_latest to get 20 recent stories"
"Use hn_top with limit 15 to get top stories"
"Use hn_best to get 25 best stories"
"Use hn_search with query 'model context protocol' to find related stories"
"Use hn_search with query 'rust' and sort date to see the newest posts"
"Use hn_story with story_id 29384756 to get story details"
"Use hn_comments with story_index 3 to get comments for the 3rd story"
"Use hn_comments with story_id 12345678 to get comments for that story"

Consultas en lenguaje natural:

También puede interactuar con el MCP usando lenguaje natural. Claude interpretará estas solicitudes y usará las herramientas apropiadas:

"Muéstrame las 30 historias principales de Hacker News hoy"
"¿Cuáles son las 40 publicaciones más recientes en Hacker News?"
"Me gustaría ver los 20 mejores artículos de Hacker News"
"¿Puedes obtenerme 30 noticias tecnológicas recientes de Hacker News?"
"Dime cuáles son los 50 temas de tendencia principales en Hacker News"
"Busca en Hacker News historias sobre aprendizaje automático"
"Obténme 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 esta semana"
"Muéstrame una lista de los 20 mejores artículos de programación de Hacker News"
"Obtén los comentarios de la historia número 5 de la última lista"
"Muéstrame los detalles de la historia con ID 12345678"

Solicitudes de traducción de idiomas:

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

"Muéstrame las 30 historias principales de Hacker News hoy en español"
"Obtén las 20 publicaciones más recientes 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 historias recientes de Hacker News traducidas al japonés"
"Obtén los 20 artículos principales de Hacker News y preséntalos en portugués"

Solución de problemas

Error de "Servidor desconectado"

Si ve el error "MCP Hacker News: Server disconnected" 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, use Claude mientras mantiene esta terminal abierta
Revise su configuración:
- Asegúrese de que la ruta absoluta en claude_desktop_config.json sea correcta para su sistema
- Verifique que haya usado dobles barras invertidas (\\) para rutas de Windows
- Confirme que está usando 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 esté siempre ejecutándose 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
Revise los registros de Claude Desktop para detectar errores de comunicación MCP
Asegúrese de que el proceso del servidor MCP esté ejecutándose (ejecútelo manualmente para confirmar)
Verifique que el servidor MCP esté correctamente registrado en el registro MCP de Claude Desktop

Verificar si el servidor está ejecutándose

Para verificar si el servidor está ejecutándose:

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 ejecutándose, inícielo manualmente o use el método de inicio automático.

Desarrollo

Ejecute la suite de pruebas (no requiere red):

npm install
npm run build
npm test

Contribuciones

¡Las contribuciones son bienvenidas! No dude en enviar una Solicitud de extracción (Pull Request).

Licencia

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

MCP Claude Hacker News

Documentación