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.

Related MCP server: Mozilla Readability Parser MCP Server

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.