Hacker News

黑客新闻MCP服务器

用于AI代理搜索的MCP服务器 黑客新闻报道.

主要组件

• ML搜索管道（ETL→ 富集→ 索引→ 份量→ 评估）
• 结合关键字+语义嵌入的混合搜索(NDCG@5：0.72，MRR 0.83）
• 基于LLM的定制评估框架，用于迭代改进
• Google Cloud Run上的无服务器MCP服务器

技术：Python、FastMCP、MongoDB Atlas向量搜索、自定义评估框架、OpenAI嵌入、Docker、GCP

现场试试

与启用MCP的客户端兼容（例如Augment、Claude Desktop）。

{
  "mcpServers": {
    "hacker-news-mcp": {
      "url": "https://hacker-news-mcp-632359460921.us-central1.run.app/mcp",
      "type": "http"
    }
  }
}

主要特点

高级设计

• 黑客新闻API-数据来源
• ETL管道：

- 在GCS中获取新故事并存储 - DAG工作流程分为5个阶段（选择→ 丰富→ 嵌入→ 结合→ 部署）

• MongoDB Atlas-使用搜索索引保存丰富的故事
• MCP服务器-具有混合搜索逻辑的搜索服务
• 人工智能代理-终端消费者

Design

混合搜索

• 组合关键字匹配+向量嵌入以提高召回率
• 按HN投票分数（社会验证）+最近度加权排名

搜索评估

• 使用自定义eval框架(Precision@KNDCG、MRR指标）
• 使用基于LLM的排名生成合成查询数据集
• 通过评估循环进行迭代改进

阅读更多关于评估

基础设施

• 无服务器部署（云运行）
• MongoDB Atlas用于混合搜索索引（文本+向量）
• 用于语义搜索的OpenAI嵌入

仓库

• ETL：https://github.com/vm-mishchenko/hacker-news-etl
• MCP服务器：https://github.com/vm-mishchenko/hacker-news-mcp

发展

设置

# Clone repository
git clone https://github.com/vm-mishchenko/hacker-news-mcp.git
cd hacker-news-mcp

# Install dependencies
pip install -r requirements.txt

# Configure environment
cp .env.example .env.local
# Edit .env.local with your credentials

在本地运行

# Start MCP server (HTTP transport)
python -m src.server

# Debug with MCP Inspector
npx @modelcontextprotocol/inspector
# Connect to: http://localhost:8000/mcp

# Or use the Python client
python -m src.client

Docker构建

docker build -t hacker-news-mcp .
docker run -p 8000:8000 --env-file .env.local hacker-news-mcp

未来的增强功能

• 评论搜索
• 动态重新排名以获得最佳结果
• 按日期范围或分数阈值筛选