Hacker新闻数据服务

提供Hacker新闻数据访问的FastMCP服务器,支持获取热门新闻、最新新闻、搜索新闻等功能,适用于Poke集成。

  • by akarnik23
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 akarnik23/mcp-hackernews

使用说明

Hacker News MCP 服务器

一个FastMCP服务器,用于为Poke集成提供访问Hacker News数据的接口。

🚀 特性

  • 获取头条新闻从Hacker News获取热门故事
  • 获取故事通过ID获取特定故事的详细信息
  • 获取新故事获取最新故事
  • 搜索故事使用Algolia API搜索故事

🛠️ 本地开发

# Install dependencies
pip install -r requirements.txt

# Run the server
python src/server.py

🚢 部署

部署到Render

步骤:

  1. 点击上方的“部署到Render”按钮 或者前往 render.com(注:这是一个域名,直接翻译为中文并无实际意义,通常保持原样使用,若需解释性翻译,可表述为“渲染网(或某渲染服务提供商的域名,具体根据上下文确定)”)
  2. 将您的GitHub帐户连接到Render (如果你还没有的话)
  3. 创建一个新的Web服务:
    • 连接此存储库
    • 名字: hackernews-mcp
    • 环境: Python 3
    • 计划: Free
    • 构建命令: pip install -r requirements.txt
    • 启动命令: python src/server.py
  4. 部署! (无需额外环境变量 - 使用公共Hacker News API)

注:在Render的免费套餐中,服务在闲置约15分钟后会进入空闲状态,并且可能需要手动执行“部署”操作来唤醒或获取最新的提交。与Vercel不同,默认情况下推送不会自动部署。

您的服务器将在 https://hackernews-mcp.onrender.com/mcp

🎯 投石(或戳点)集成

  1. 首选 poke.com/settings/connections 翻译为中文是:“poke.com 的设置/连接(页面)”
  2. 添加MCP URL: https://hackernews-mcp.onrender.com/mcp
  3. 给它起个名字,比如“黑客新闻”
  4. 尝试:“你能用Hacker News MCP来获取头条新闻吗?”

参考文献

🔧 可用工具

  • get_top_stories(limit=10)获取头条新闻(最多30条)
  • get_story(story_id)获取具体的故事细节
  • get_new_stories(limit=10)获取最新故事(最多30个)
  • search_stories(query, limit=10)搜索故事(最多20个)

📝 示例用法

# Get top 5 stories
get_top_stories(limit=5)

# Get story details
get_story(story_id=12345)

# Search for Python stories
search_stories(query="python", limit=5)