项目介绍 - GeekNews MCP 服务器

此项目是从 GeekNews 获取文章的 Model Context Protocol (MCP) 服务器，使用 Python 实现，并采用 BeautifulSoup 进行网页抓取。为了减少服务器负载，该项目提供每天自动解析数据并存储到缓存中的功能。

功能

工具 (Tools)

• get_articles 工具: 从 GeekNews 获取文章的功能

  • 可指定文章类型（top、new、ask、show）和返回的文章数量
  • 每个响应包含标题、URL、点数、作者、时间、评论数、排名信息等
  • 使用缓存数据以减少服务器负载

• get_weekly_news 工具: 从 GeekNews 获取周报的功能

  • 可指定特定的周报 ID 或获取最新的周报
  • 提供周报的标题、编号、ID、内容、URL、项目列表等信息
  • 每个项目包含标题、URL、排名信息等
  • 使用缓存数据以减少服务器负载

缓存功能

• 每天自动解析一次数据并存储到缓存中
• 在缓存数据有效期内，使用缓存数据而不向 GeekNews 服务器发起请求
• 缓存数据有效期为 24 小时，之后自动更新
• 定时器定期检查缓存的有效性，并在必要时进行更新

使用方法

• 通过 Smithery 安装

  🚀 geeknews-mcp-server

• 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
   

代码结构

• server.py: 服务器主程序，处理请求和响应。
• crawler.py: 负责从 GeekNews 抓取数据的爬虫模块。
• cache_manager.py: 管理缓存数据的模块，包括读取、写入和更新操作。
• tools: 包含各种辅助工具函数的目录。

注意事项

• 项目依赖于 GeekNews 的 HTML 结构，如果结构发生变化，可能需要调整爬虫逻辑。
• 缓存数据存储在用户的主目录下的 .cache/geeknews-mcp 文件夹中。