GeekNews MCP Server

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

function

Tools

• get_articles tool: Ability to fetch articles from GeekNews

  • You can specify the article type (top, new, ask, show) and the number of articles to return.

  • Each response contains title, URL, points, author, time, number of comments, and ranking information.

• get_weekly_news tool: Ability to fetch weekly news from GeekNews

  • You can specify a specific weekly news ID or retrieve the most recent weekly news.

  • Provides information such as the title, number, ID, content, URL, and list of items of weekly news.

  • Each item contains a title, URL, and ranking information.

How to use

• Installation using Smithery

  🚀 geeknews-mcp-server

• Add server information to the MCP settings file

  { "mcpServers": { "geeknews-mcp-server": { "command": "npx", "args": [ "-y", "@smithery/cli@latest", "run", "@the0807/geeknews-mcp-server", "--key", "smithery에서 발급 받은 키" ] } } }

How to install locally

1. Git Clone

   git clone https://github.com/the0807/GeekNews-MCP-Server cd GeekNews-MCP-Server

2. Setting the environment with uv

   uv sync

3. Running a virtual environment

   uv venv source .venv/bin/activate

4. Testing your server with MCP Inspector

   uv run mcp mcp dev main.py # 터미널에 나오는 URL(MCP Inspector)로 접속하여 서버 테스트

Code Structure

• src/models.py : Define a data class that stores article information.

• src/parser.py : Parses HTML from the GeekNews website to extract article information.

• src/client.py : HTTP client that fetches data from the GeekNews website.

• src/config.py : Define settings and constants

• src/server.py : MCP server implementation

• main.py : Server execution entry point

[!Note]

• This server relies on the HTML structure of the GeekNews website. If the website structure changes, you may need to update your parsing logic.