geeknews-mcp-server

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 结构。如果您的网站结构发生变化，您可能需要更新您的解析逻辑。