Hacker News Mcp Server

O que é o hn-server?

O ### hn-server é um repositório público criado pelo usuário ### pskill9 no GitHub. Ele serve como uma implementação de servidor para o Hacker News, um popular site de notícias sociais que foca em ciência da computação e empreendedorismo. Este projeto permite que os usuários interajam com o Hacker News através de uma aplicação do lado do servidor, possibilitando funcionalidades como buscar artigos de notícias, enviar histórias e comentar, tudo isso enquanto adere à API do Hacker News.

Recursos do hn-server

• Acesso Público: O repositório está aberto ao público, permitindo que qualquer pessoa visualize, faça fork ou contribua para o projeto.
• Licença MIT: O projeto é licenciado sob a licença MIT, que permite aos usuários usar, copiar, modificar e distribuir o software.
• Comunidade Ativa: O repositório atraiu atenção com 35 estrelas e 8 forks, indicando um crescente interesse e envolvimento da comunidade.
• Integração Fácil: O servidor pode ser facilmente integrado com várias aplicações, proporcionando uma experiência contínua para desenvolvedores que desejam utilizar dados do Hacker News.
• Documentação: Documentação abrangente está disponível para ajudar os usuários a entender como configurar e usar o servidor de forma eficaz.

Como Usar o hn-server

1. Clone o Repositório: Comece clonando o repositório hn-server para sua máquina local usando o comando:

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

2. Instale Dependências: Navegue até o diretório do projeto e instale as dependências necessárias. Isso pode ser feito normalmente usando um gerenciador de pacotes como npm ou yarn, dependendo da configuração do projeto.

3. Execute o Servidor: Após instalar as dependências, você pode executar o servidor usando o comando especificado na documentação (geralmente algo como npm start).

4. Interaja com a API: Uma vez que o servidor esteja em execução, você pode interagir com os endpoints da API do Hacker News para buscar artigos de notícias, enviar histórias e mais.

5. Contribua: Se você deseja contribuir para o projeto, sinta-se à vontade para fazer um fork do repositório, fazer suas alterações e enviar um pull request.

Perguntas Frequentes

Quais tecnologias são usadas no hn-server?

O hn-server é tipicamente construído usando JavaScript e Node.js, aproveitando várias bibliotecas e frameworks para facilitar operações do lado do servidor.

Posso contribuir para o projeto hn-server?

Sim! Contribuições são bem-vindas. Você pode fazer um fork do repositório, fazer alterações e enviar um pull request para revisão.

Existe uma maneira de executar o hn-server localmente?

Absolutamente! Você pode clonar o repositório e seguir as instruções de configuração na documentação para executá-lo em sua máquina local.

Qual é o propósito da licença MIT?

A licença MIT permite que os usuários usem, modifiquem e distribuam o software livremente, promovendo a colaboração e inovação em código aberto.

Como posso relatar problemas ou bugs?

Você pode relatar problemas navegando até a aba "Issues" no repositório do hn-server no GitHub e enviando um novo problema com detalhes sobre o problema que você está enfrentando.

Hacker News MCP Server

A Model Context Protocol (MCP) server that provides tools for fetching stories from Hacker News. This server parses the HTML content from news.ycombinator.com and provides structured data for different types of stories (top, new, ask, show, jobs).

<a href="https://glama.ai/mcp/servers/oge85xl22f"><img width="380" height="200" src="https://glama.ai/mcp/servers/oge85xl22f/badge" alt="Hacker News MCP server" /></a>

Features

• Fetch different types of stories (top, new, ask, show, jobs)
• Get structured data including titles, URLs, points, authors, timestamps, and comment counts
• Configurable limit on number of stories returned
• Clean error handling and validation

Installation

1. Clone the repository:

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

2. Install dependencies:

npm install

3. Build the server:

npm run build

4. Add to your MCP settings configuration file (location depends on your system):

For VSCode Claude extension:

{
  "mcpServers": {
    "hacker-news": {
      "command": "node",
      "args": ["/path/to/hn-server/build/index.js"]
    }
  }
}

Usage

The server provides a tool called get_stories that can be used to fetch stories from Hacker News.

Tool: get_stories

Parameters:

• type (string): Type of stories to fetch
  • Options: 'top', 'new', 'ask', 'show', 'jobs'
  • Default: 'top'
• limit (number): Number of stories to return
  • Range: 1-30
  • Default: 10

Example usage:

use_mcp_tool with:
server_name: "hacker-news"
tool_name: "get_stories"
arguments: {
  "type": "top",
  "limit": 5
}

Sample output:

[
  {
    "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
]

Integrating with Claude

To use this MCP server with Claude, you'll need to:

1. Have the Claude desktop app or VSCode Claude extension installed
2. Configure the MCP server in your settings
3. Use Claude's natural language interface to interact with Hacker News

Configuration

For the Claude desktop app, add the server configuration to:

// ~/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"]
    }
  }
}

For the VSCode Claude extension, add to:

// VSCode Settings JSON
{
  "mcpServers": {
    "hacker-news": {
      "command": "node",
      "args": ["/path/to/hn-server/build/index.js"]
    }
  }
}

Example Interactions

Once configured, you can interact with Claude using natural language to fetch Hacker News stories. Examples:

• "Show me the top 5 stories from Hacker News"
• "What are the latest Ask HN posts?"
• "Get me the top Show HN submissions from today"

Claude will automatically use the appropriate parameters to fetch the stories you want.

Story Object Structure

Each story object contains:

• title (string): The story title
• url (string, optional): URL of the story (may be internal HN URL for text posts)
• points (number): Number of upvotes
• author (string): Username of the poster
• time (string): Timestamp of when the story was posted
• commentCount (number): Number of comments
• rank (number): Position in the list

Development

The server is built using:

• TypeScript
• Model Context Protocol SDK
• Axios for HTTP requests
• Cheerio for HTML parsing

To modify the server:

1. Make changes to src/index.ts
2. Rebuild:

npm run build

Error Handling

The server includes robust error handling for:

• Invalid story types
• Network failures
• HTML parsing errors
• Invalid parameter values

Errors are returned with appropriate error codes and descriptive messages.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - feel free to use this in your own projects.