GeekNews MCP Server

What is GeekNews MCP Server?

It is a Model Context Protocol (MCP) server that fetches articles from GeekNews (https://news.hada.io) using Python and BeautifulSoup for web scraping. Designed for developers and AI agents, it provides tools to retrieve articles and weekly news with automatic daily caching to reduce server load.

How to use GeekNews MCP Server?

Install via Smithery using the provided npx command with a Smithery key, or clone the repository and set up locally with uv sync and uv dev. Add the server configuration to your MCP client’s settings file, then test using MCP Inspector (mcp dev main.py).

Key features of GeekNews MCP Server

• Fetches GeekNews articles and weekly news.
• Supports article types: top, new, ask, show.
• Returns title, URL, points, author, time, comments, rank.
• Provides weekly news with item details and content.
• Automatic caching with 24‑hour validity.
• Reduces server load via daily data refresh.

Use cases of GeekNews MCP Server

• Stay updated with top GeekNews articles without manual browsing.
• Fetch weekly news summaries for review or archival.
• Integrate GeekNews data into AI assistants or chatbots via MCP.
• Automate retrieval of specific article types (ask, show) for analysis.

FAQ from GeekNews MCP Server

What data does the server fetch?

It fetches articles and weekly news from GeekNews. Each article includes title, URL, points, author, time, comments, and rank. Weekly news includes title, number, ID, content, URL, and a list of items with rank.

How does caching work?

The server parses data once per day and caches it in ~/.cache/geeknews-mcp. The cache is valid for 24 hours and automatically refreshed by a scheduler.

What are the runtime dependencies?

Python, uv (Python package manager), and BeautifulSoup (for HTML parsing). The server is written in Python.

Are there any limitations?

The server depends on GeekNews’ HTML structure. If the site changes its layout, the parsing logic may need updating.