GeekNews MCP Server

このプロジェクトは、 GeekNewsから記事をインポートするModel Context Protocol（MCP）サーバーです。 Pythonとして実装されており、BeautifulSoupを使用してWebスクレイピングを実行します。

機能

ツール(Tools)

• get_articlesツール：GeekNewsから記事をインポートする機能

  • 記事の種類（top、new、ask、show）と返す記事の数を指定できます。

  • 各回答には、件名、URL、ポイント、作成者、時間、コメント数、ランキング情報が含まれています

• get_weekly_newsツール：GeekNewsから毎週ニュースを取得する機能

  • 特定の週間ニュースIDを指定したり、最新の週間ニュースを取得したりできます

  • 週刊ニュースのタイトル、番号、ID、コンテンツ、URL、アイテムリストなどの情報を提供

  • 各アイテムにはタイトル、URL、ランキング情報が含まれています

Related MCP server: Mozilla Readability Parser MCP Server

使い方

• Smitheryを使用したインストール

  🚀 geeknews-mcp-server

• MCP設定ファイルにサーバー情報を追加する

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

ローカルインストール方法

1. Git Clone

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

2. uvによる環境設定

   uv sync

3. 仮想環境の実行

   uv venv
   source .venv/bin/activate

4. MCP Inspectorでサーバーをテストする

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

コード構造

• src/models.py ：記事情報を格納するデータクラスの定義

• src/parser.py ：GeekNewsウェブサイトのHTMLを解析して記事情報を抽出する

• src/client.py ：GeekNewsウェブサイトからデータを取得するHTTPクライアント

• src/config.py ：設定と定数の定義

• src/server.py : MCPサーバーの実装

• main.py : サーバー実行エントリポイント

[!Note]

• このサーバーはGeekNews WebサイトのHTML構造に依存しています。 Webサイトの構造が変更された場合は、解析ロジックを更新する必要があります。