GeekNews MCP Server logo

GeekNews MCP Server

by the0807

This project is a Model Context Protocol (MCP) server that fetches articles from GeekNews. It is implemented in Python and uses BeautifulSoup for web scraping.

View on GitHub

Last updated: N/A

What is GeekNews MCP Server?

The GeekNews MCP Server is a Python-based server that retrieves articles from the GeekNews website (news.hada.io) using web scraping techniques. It utilizes the Model Context Protocol (MCP) to provide structured access to news data.

How to use GeekNews MCP Server?

The server can be installed using Smithery or by manually cloning the repository and setting up the environment with uv. After installation, configure the MCP settings file with the server information and test it using the MCP Inspector.

Key features of GeekNews MCP Server

  • Fetches articles from GeekNews (top, new, ask, show)

  • Provides weekly news retrieval with specific ID or latest

  • Implements a caching mechanism to reduce server load

  • Automatically parses and caches data once a day

Use cases of GeekNews MCP Server

  • Integrating GeekNews articles into other applications

  • Building custom news dashboards

  • Analyzing trends in GeekNews content

  • Creating personalized news feeds

FAQ from GeekNews MCP Server

Where is the cache data stored?

Cache data is stored in the .cache/geeknews-mcp folder under the user's home directory.

How often is the cache updated?

The cache is automatically updated once a day.

What happens if the GeekNews website structure changes?

The parsing logic in src/parser.py needs to be updated to reflect the changes in the website's HTML structure.

What tools are available?

The server provides get_articles and get_weekly_news tools to retrieve articles and weekly news respectively.

How do I test the server locally?

Use the MCP Inspector after setting up the environment and running the server with uv run mcp and mcp dev main.py.