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 文件夹中。