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 和排名信息

使用方法

• 使用 Smithery 进行安装

  🚀 geeknews-mcp-server

• 将服务器信息添加到 MCP 配置文件

  {
  "mcpServers": {
     "geeknews-mcp-server": {
        "command": "npx",
        "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "@the0807/geeknews-mcp-server",
        "--key",
        "smithery에서 발급 받은 키" // 请替换为 Smithery 颁发的密钥
        ]
     }
  }
  }
  

本地安装方法

1. Git Clone

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

2. 使用 uv 设置环境

   uv sync
   

3. 运行虚拟环境

   uv venv
   source .venv/bin/activate
   

4. 使用 MCP Inspector 测试服务器

   uv run mcp
   mcp dev main.py
   
   # 访问终端中显示的 URL (MCP Inspector) 以测试服务器
   

代码结构

• src/models.py: 定义用于存储文章信息的数据类
• src/parser.py: 解析 GeekNews 网站的 HTML 以提取文章信息
• src/client.py: 从 GeekNews 网站获取数据的 HTTP 客户端
• src/config.py: 定义配置和常量
• src/server.py: MCP 服务器实现
• main.py: 服务器运行入口点

[!Note]

• 此服务器依赖于 GeekNews 网站的 HTML 结构。如果网站结构发生更改，可能需要更新解析逻辑。