MCP Claude Hacker News

Interaja com o Hacker News através do Model Context Protocol (MCP), projetado para o Claude Desktop.

GitHub

Experimente este MCPPatrocinado

Documentação

MCP Claude Hacker News

Uma integração que permite ao Claude Desktop interagir com o Hacker News usando o Model Context Protocol (MCP).

Recursos

Navegue pelas últimas histórias do Hacker News
Veja histórias mais votadas e melhores avaliadas
Pesquise histórias por palavra-chave, por relevância ou mais recentes (Algolia HN Search API)
Obtenha detalhes das histórias
Leia comentários das histórias, limitados para que uma discussão movimentada não sobrecarregue o contexto
Formatação limpa do conteúdo do Hacker News para melhor legibilidade, incluindo decodificação de entidades HTML

Demonstração

Requisitos

Node.js 20 ou superior
Claude Desktop
Conexão com a internet para acessar a API do Hacker News

Instalação

Instalando via Smithery

Instale o pacote empacotado na página do servidor Smithery, ou pela CLI:

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

Instalação Manual

Clone ou baixe este repositório:

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

Instale as dependências:

npm install

Compile o projeto:

npm run build

Executando o Servidor MCP

Existem duas maneiras de executar o servidor MCP:

Opção 1: Execução manual

Abra um terminal ou prompt de comando
Navegue até o diretório do projeto
Execute o servidor diretamente:

node build/index.js

Mantenha esta janela do terminal aberta enquanto usa o Claude Desktop. O servidor será executado até você fechar o terminal.

Opção 2: Inicialização automática com o Claude Desktop (recomendado para uso regular)

O Claude Desktop pode iniciar automaticamente o servidor MCP quando necessário. Para configurar isso:

Configuração

O arquivo de configuração do Claude Desktop está localizado em:

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 arquivo para adicionar a configuração do MCP do Hacker News. Se o arquivo não existir, crie-o:

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

Importante: Substitua ABSOLUTE_PATH_TO_DIRECTORY pelo caminho absoluto completo onde você instalou o MCP

Exemplo macOS/Linux: /Users/username/mcp-claude-hackernews
Exemplo Windows: C:\\Users\\username\\mcp-claude-hackernews

Se você já tiver outros MCPs configurados, basta adicionar a seção "hackerNews" dentro do objeto "mcpServers". Aqui está um exemplo de configuração com múltiplos MCPs:

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

O servidor MCP será iniciado automaticamente quando o Claude Desktop precisar, com base na configuração do seu arquivo claude_desktop_config.json.

Uso

Reinicie o Claude Desktop após modificar a configuração
No Claude, use as ferramentas do Hacker News para interagir com o Hacker News
O servidor MCP é executado como um processo filho gerenciado pelo Claude Desktop

Ferramentas Disponíveis

O MCP do Hacker News fornece 6 ferramentas especializadas para diferentes funções:

Ferramenta	Descrição	Parâmetros	Exemplo de Uso
`hn_latest`	Obter as histórias mais recentes do Hacker News	`limit`: Número opcional de histórias (1-50, padrão: 10)	Obter as 20 histórias mais recentes
`hn_top`	Obter as histórias mais bem classificadas do Hacker News	`limit`: Número opcional de histórias (1-50, padrão: 10)	Obter as 15 principais histórias
`hn_best`	Obter as melhores histórias do Hacker News	`limit`: Número opcional de histórias (1-50, padrão: 10)	Obter as 25 melhores histórias
`hn_search`	Pesquisar histórias por palavra-chave	`query`: Termos de pesquisa obrigatórios; `limit`: 1-50 (padrão: 10); `sort`: `relevance` (padrão) ou `date`	Pesquisar "rust async" ordenado por data
`hn_story`	Obter informações detalhadas sobre uma história específica	`story_id`: ID da história obrigatório (número)	Obter detalhes da história por ID
`hn_comments`	Obter comentários de nível superior de uma história	`story_id`: ID da história (número) OU `story_index`: Índice da última lista (baseado em 1); `limit`: 1-50 (padrão: 20)	Obter comentários por ID da história ou índice

Detalhes dos Parâmetros das Ferramentas

`hn_latest`, `hn_top`, `hn_best`

limit (opcional): Número de histórias a buscar
- Tipo: Número
- Intervalo: 1-50
- Padrão: 10

`hn_search`

query (obrigatório): Termos de pesquisa
- Tipo: String
- Exemplo: "model context protocol"
limit (opcional): Número de resultados, 1-50, padrão 10
sort (opcional): relevance (padrão) ou date para mais recentes primeiro

`hn_story`

story_id (obrigatório): O ID da história a buscar
- Tipo: Número
- Exemplo: 12345678

`hn_comments`

story_id (opcional): O ID da história para obter comentários
- Tipo: Número
- Exemplo: 12345678
story_index (opcional): O índice da história da última lista buscada
- Tipo: Número (baseado em 1)
- Exemplo: 3 (para a 3ª história da última lista)
limit (opcional): Número máximo de comentários de nível superior a retornar
- Tipo: Número
- Intervalo: 1-50
- Padrão: 20

Nota: Para hn_comments, você deve fornecer story_id OU story_index. Apenas comentários de nível superior são buscados; a contagem de respostas é informada por comentário. A resposta indica quantos comentários de nível superior da discussão foram retornados.

Exemplos de Uso

Aqui estão vários exemplos de como usar o MCP do Hacker News com o Claude:

Uso Direto da Ferramenta:

"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 em Linguagem Natural:

Você também pode interagir com o MCP usando linguagem natural. O Claude interpretará essas solicitações e usará as ferramentas apropriadas:

"Mostre-me as 30 principais histórias do Hacker News hoje"
"Quais são as 40 postagens mais recentes do Hacker News?"
"Gostaria de ver os 20 melhores artigos do Hacker News"
"Você pode buscar 30 notícias recentes de tecnologia do Hacker News?"
"Diga-me quais são os 50 tópicos em alta no Hacker News"
"Pesquise no Hacker News histórias sobre aprendizado de máquina"
"Traga-me os 40 títulos mais recentes do Hacker News"
"Quais são as 30 discussões mais ativas no Hacker News agora?"
"Estou interessado em ler os 40 artigos mais populares do Hacker News esta semana"
"Mostre-me uma lista dos 20 melhores artigos de programação do Hacker News"
"Obtenha os comentários da história número 5 da última lista"
"Mostre-me os detalhes da história ID 12345678"

Solicitações de Tradução de Idioma:

Você pode solicitar que o conteúdo do Hacker News seja traduzido para diferentes idiomas:

"Mostre-me as 30 principais histórias do Hacker News hoje em espanhol"
"Obtenha as 20 postagens mais recentes do Hacker News e traduza-as para o francês"
"Gostaria de ver os 40 melhores artigos do Hacker News em alemão"
"Mostre-me 30 histórias recentes do Hacker News traduzidas para o japonês"
"Obtenha os 20 principais artigos do Hacker News e apresente-os em português"

Solução de Problemas

Erro "Servidor desconectado"

Se você vir o erro "MCP Hacker News: Server disconnected" no Claude Desktop:

Verifique se o servidor está em execução:
- Abra um terminal e execute manualmente node build/index.js a partir do diretório do projeto
- Se o servidor iniciar com sucesso, use o Claude mantendo este terminal aberto
Verifique sua configuração:
- Certifique-se de que o caminho absoluto em claude_desktop_config.json está correto para o seu sistema
- Verifique se você usou barras invertidas duplas (\\) para caminhos do Windows
- Confirme que você está usando o caminho completo a partir da raiz do seu sistema de arquivos
Experimente a opção de inicialização automática:
- Configure o script de inicialização automática para o seu sistema operacional conforme descrito na seção "Configurando scripts de inicialização automática"
- Isso garante que o servidor esteja sempre em execução quando você precisar

Ferramentas não aparecendo no Claude

Se as ferramentas do Hacker News não aparecerem no Claude:

Certifique-se de ter reiniciado o Claude Desktop após a configuração
Verifique os logs do Claude Desktop para erros de comunicação MCP
Garanta que o processo do servidor MCP esteja em execução (execute manualmente para confirmar)
Verifique se o servidor MCP está registrado corretamente no registro MCP do Claude Desktop

Verificando se o servidor está em execução

Para verificar se o servidor está em execução:

Windows: Abra o Gerenciador de Tarefas, vá para a aba "Detalhes" e procure por "node.exe"
macOS/Linux: Abra o Terminal e execute ps aux | grep node

Se você não vir o servidor em execução, inicie-o manualmente ou use o método de inicialização automática.

Desenvolvimento

Execute a suíte de testes (sem necessidade de rede):

npm install
npm run build
npm test

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

Este projeto está licenciado sob a Mozilla Public License 2.0 - consulte o arquivo LICENSE para detalhes.

MCP Claude Hacker News

Documentação

MCP Claude Hacker News

Recursos

Demonstração

Requisitos

Instalação

Instalando via Smithery

Instalação Manual

Executando o Servidor MCP

Opção 1: Execução manual

Opção 2: Inicialização automática com o Claude Desktop (recomendado para uso regular)

Configuração

Uso

Ferramentas Disponíveis

Detalhes dos Parâmetros das Ferramentas

hn_latest, hn_top, hn_best

hn_search

hn_story

hn_comments

Exemplos de Uso

Uso Direto da Ferramenta:

Consultas em Linguagem Natural:

Solicitações de Tradução de Idioma:

Solução de Problemas

Erro "Servidor desconectado"

Ferramentas não aparecendo no Claude

Verificando se o servidor está em execução

Desenvolvimento

Contribuindo

Licença

Links Relacionados

`hn_latest`, `hn_top`, `hn_best`

`hn_search`

`hn_story`

`hn_comments`