Geeknews MCP Server

🚀 極客ニュース MCP サーバー

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

🚀 クイックスタート

このサーバーを使用することで、GeekNews から記事や週報を取得することができます。以下に、使用方法やインストール手順を説明します。

✨ 主な機能

ツール

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

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

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

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

キャッシュ機能

• 毎日自動的にデータを解析してキャッシュに保存します。
• キャッシュデータの有効期間内は、GeekNews サーバーにアクセスすることなく、キャッシュデータを直接使用します。
• キャッシュデータの有効期間は 24 時間で、その後自動的に更新されます。
• タイマーが定期的にキャッシュの有効性をチェックし、必要に応じて更新します。

📦 インストール

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 でクローンする

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

2. uv を使用して環境を設定する

uv sync

3. 依存関係をインストールする

pip install -r requirements.txt

4. サーバーを起動する

python main.py

💻 使用例

基本的な使用法

get_articles の使用例

# ここに get_articles の使用例コードを追加する予定です。

get_weekly_news の使用例

# ここに get_weekly_news の使用例コードを追加する予定です。

⚠️ 重要提示

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