GeekNews MCP 服务器

该项目是一个从GeekNews获取文章的模型上下文协议 (MCP) 服务器。它是用 Python 实现的，并使用 BeautifulSoup 执行网页抓取。

功能

工具

• get_articles工具：能够从 GeekNews 获取文章

  • 您可以指定文章类型（热门、新、询问、显示）和要返回的文章数量。

  • 每个回复包含标题、URL、积分、作者、时间、评论数、排名信息。

• get_weekly_news工具：能够从 GeekNews 获取每周新闻

  • 您可以指定特定的每周新闻 ID 或检索最新的每周新闻。

  • 提供每周新闻的标题、编号、ID、内容、URL、条目列表等信息。

  • 每个项目包含标题、URL 和排名信息。

如何使用

• 使用 Smithery 安装

  🚀 geeknews-mcp-服务器

• 将服务器信息添加到 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. 运行虚拟环境

   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 ：服务器执行入口点

[！笔记]

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