Geeknews

🚀 プロジェクト紹介 - GeekNews MCP サーバー

このプロジェクトは、GeekNews から記事を取得する Model Context Protocol (MCP) サーバーです。Python で実装され、BeautifulSoup を使用してウェブページをスクレイピングしています。サーバーの負荷を軽減するため、毎日自動的にデータを解析してキャッシュに保存する機能を提供しています。

🚀 クイックスタート

この MCP サーバーを使用することで、GeekNews から記事や週報を簡単に取得できます。以下に具体的な使い方を説明します。

✨ 主な機能

ツール (Tools)

• get_articles ツール: GeekNews から記事を取得する機能です。

  • 記事のタイプ（top、new、ask、show）と返す記事の数を指定できます。
  • 各レスポンスには、タイトル、URL、点数、著者、時間、コメント数、ランキング情報などが含まれます。
  • キャッシュデータを使用してサーバーの負荷を軽減します。

• get_weekly_news ツール: GeekNews から週報を取得する機能です。

  • 特定の週報 ID を指定するか、最新の週報を取得できます。
  • 週報のタイトル、番号、ID、内容、URL、プロジェクトリストなどの情報を提供します。
  • 各プロジェクトには、タイトル、URL、ランキング情報などが含まれます。
  • キャッシュデータを使用してサーバーの負荷を軽減します。

キャッシュ機能

• 毎日自動的にデータを解析し、キャッシュに保存します。
• キャッシュデータの有効期間内は、キャッシュデータを使用し、GeekNews サーバーにリクエストを送信しません。
• キャッシュデータの有効期間は 24 時間で、その後自動的に更新されます。
• タイマーが定期的にキャッシュの有効性をチェックし、必要に応じて更新します。

📦 インストール

ローカルインストールガイド

1. リポジトリをクローンする

   git clone https://github.com/yourusername/geeknews-mcp-server.git
   cd geeknews-mcp-server
   

2. 環境を設定する 依存関係をインストールします。

   pip install -r requirements.txt
   

3. サーバーを起動する

   python server.py
   

Smithery を通じたインストール

🚀 geeknews-mcp-server

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

{
    "mcp_settings": {
        "servers": {
            "geeknews_mcp_server": {
                "url": "http://localhost:5000",
                "api_key": "your_api_key"
            }
        }
    }
}

🔧 技術詳細

コード構造

• server.py: サーバーのメインプログラムで、リクエストとレスポンスを処理します。
• crawler.py: GeekNews からデータを取得するクローラーモジュールです。
• cache_manager.py: キャッシュデータを管理するモジュールで、読み取り、書き込み、更新操作を行います。
• tools: 様々なヘルパー関数が含まれるディレクトリです。

注意事項

• このプロジェクトは GeekNews の HTML 構造に依存しているため、構造が変更された場合、クローラーのロジックを調整する必要があります。
• キャッシュデータはユーザーのホームディレクトリ下の .cache/geeknews-mcp フォルダに保存されます。