Geeknews MCP Server

🚀 極客新聞 MCP 服務器

此項目是一個基於 Model Context Protocol (MCP) 的服務器，使用 Python 實現，藉助 BeautifulSoup 進行網絡爬蟲，可從 GeekNews 獲取文章。為減輕服務器負載，該項目提供了每日自動解析數據並存儲於緩存的功能。

🚀 快速開始

通過 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 工具

該工具用於從 GeekNews 獲取文章，具備以下特點：

• 可指定文章類型（top, new, ask, show）和返回的文章數量。
• 每個響應包含標題、URL、點數、作者、時間、評論數、排名信息。
• 使用緩存數據以減少服務器負載。

get_weekly_news 工具

此工具用於從 GeekNews 獲取週報，支持以下操作：

• 可指定特定週報 ID 或獲取最新週報。
• 提供週報的標題、編號、ID、內容、URL、項目列表等信息。
• 每個項目包含標題、URL、排名信息。
• 使用緩存數據以減少服務器負載。

緩存功能

• 每天自動解析數據並存儲在緩存中。
• 在緩存數據有效期內直接使用緩存數據，無需訪問 GeekNews 服務器。
• 緩存數據有效期為 24 小時，之後自動更新。
• 定時器定期檢查緩存有效性，並在需要時進行更新。

⚠️ 重要提示

• 該項目依賴於 GeekNews 網站的結構，如果網站結構發生變化，可能需要調整爬蟲邏輯。
• 緩存數據存儲在用戶主目錄下的 .cache/geeknews-mcp 文件夾中。