Hacker News Mcp Сервер

Что такое hn-server?

hn-server — это публичный репозиторий, созданный пользователем ### pskill9 на GitHub. Он служит реализацией сервера для Hacker News, популярного социального новостного сайта, который фокусируется на компьютерных науках и предпринимательстве. Этот проект позволяет пользователям взаимодействовать с Hacker News через серверное приложение, обеспечивая такие функции, как получение новостных статей, отправка историй и комментариев, при этом соблюдая API Hacker News.

Особенности hn-server

• Публичный доступ: Репозиторий открыт для публики, что позволяет любому просматривать, форкать или вносить вклад в проект.
• Лицензия MIT: Проект лицензирован под лицензией MIT, которая позволяет пользователям использовать, копировать, модифицировать и распространять программное обеспечение.
• Активное сообщество: Репозиторий привлек внимание с 35 звездами и 8 форками, что указывает на растущий интерес и участие сообщества.
• Легкая интеграция: Сервер можно легко интегрировать с различными приложениями, обеспечивая бесшовный опыт для разработчиков, желающих использовать данные Hacker News.
• Документация: Доступна обширная документация, чтобы помочь пользователям понять, как эффективно настроить и использовать сервер.

Как использовать hn-server

1. Клонируйте репозиторий: Начните с клонирования репозитория hn-server на ваш локальный компьютер с помощью команды:

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

2. Установите зависимости: Перейдите в каталог проекта и установите необходимые зависимости. Это обычно можно сделать с помощью менеджера пакетов, такого как npm или yarn, в зависимости от настройки проекта.

3. Запустите сервер: После установки зависимостей вы можете запустить сервер, используя команду, указанную в документации (обычно что-то вроде npm start).

4. Взаимодействуйте с API: Как только сервер запущен, вы можете взаимодействовать с конечными точками API Hacker News, чтобы получать новостные статьи, отправлять истории и многое другое.

5. Вносите вклад: Если вы хотите внести вклад в проект, не стесняйтесь форкать репозиторий, вносить изменения и отправлять запрос на слияние.

Часто задаваемые вопросы

Какие технологии используются в hn-server?

hn-server обычно создается с использованием JavaScript и Node.js, используя различные библиотеки и фреймворки для облегчения серверных операций.

Могу ли я внести вклад в проект hn-server?

Да! Вклады приветствуются. Вы можете форкать репозиторий, вносить изменения и отправлять запрос на слияние на рассмотрение.

Есть ли способ запустить hn-server локально?

Абсолютно! Вы можете клонировать репозиторий и следовать инструкциям по настройке в документации, чтобы запустить его на вашем локальном компьютере.

Какова цель лицензии MIT?

Лицензия MIT позволяет пользователям свободно использовать, модифицировать и распространять программное обеспечение, способствуя сотрудничеству и инновациям в открытом исходном коде.

Как я могу сообщить о проблемах или ошибках?

Вы можете сообщить о проблемах, перейдя на вкладку "Issues" в репозитории hn-server на GitHub и отправив новую проблему с деталями о возникшей у вас проблеме.

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.