Geeknews

🚀 項目介紹 - GeekNews MCP 服務器

此項目是一個基於 Model Context Protocol (MCP) 的服務器，它使用 Python 實現，藉助 BeautifulSoup 從 GeekNews 抓取文章。為了降低服務器負載，該項目支持每天自動解析數據並存儲到緩存中。

🚀 快速開始

安裝方式

• 通過 Smithery 安裝：點擊 🚀 geeknews-mcp-server 進行安裝。
• MCP 設置文件中添加服務器信息：在 MCP 設置文件中添加如下內容：

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

本地安裝指南

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

✨ 主要特性

工具展示

工具詳情

• get_articles 工具：具備從 GeekNews 獲取文章的功能。
  • 可以指定文章類型（top、new、ask、show）和返回的文章數量。
  • 每個響應包含標題、URL、點數、作者、時間、評論數、排名信息等。
  • 使用緩存數據以減少服務器負載。
• get_weekly_news 工具：能夠從 GeekNews 獲取週報。
  • 可指定特定的週報 ID 或獲取最新的週報。
  • 提供週報的標題、編號、ID、內容、URL、項目列表等信息。
  • 每個項目包含標題、URL、排名信息等。
  • 使用緩存數據以減少服務器負載。

緩存功能

• 每天自動解析一次數據並存儲到緩存中。
• 在緩存數據有效期內，使用緩存數據而不向 GeekNews 服務器發起請求。
• 緩存數據有效期為 24 小時，之後自動更新。
• 定時器定期檢查緩存的有效性，並在必要時進行更新。

🔧 技術細節

代碼結構

• server.py：服務器主程序，負責處理請求和響應。
• crawler.py：負責從 GeekNews 抓取數據的爬蟲模塊。
• cache_manager.py：管理緩存數據的模塊，包括讀取、寫入和更新操作。
• tools：包含各種輔助工具函數的目錄。

注意事項

⚠️ 重要提示

項目依賴於 GeekNews 的 HTML 結構，如果結構發生變化，可能需要調整爬蟲邏輯。

💡 使用建議

緩存數據存儲在用戶的主目錄下的 .cache/geeknews-mcp 文件夾中。