HackerNews MCP Server

一个全面的模型上下文协议（MCP）服务器，提供与HackerNews API的无缝集成，使AI助手能够通过标准化的MCP接口访问、分析和理解HackerNews内容。

🚀 快速开始

# 安装依赖
npm install

# 构建项目
npm run build

# 启动服务器
npm start

然后重启你的MCP兼容客户端（如Cursor）以连接到服务器。

✨ 特性

🔧 工具（5个交互命令）

1. search_posts - 搜索和过滤HackerNews帖子

   • 根据关键词、作者、分数和日期范围进行筛选
   • 示例："找到关于'AI'且分数大于100的故事"

2. get_post - 获取完整的帖子详情

   • 包括元数据、评论树和互动指标
   • 示例："获取故事44473319的全部详情及其评论"

3. search_user - 分析用户资料和活动

   • 用户统计、顶级故事和贡献模式
   • 示例："分析用户'pg'并显示其活动"

4. search_trending - 查找当前热门话题

   • 从顶级故事中分析关键词频率
   • 示例："今天HackerNews上有哪些热门话题？"

5. search_comments - 分析评论互动

   • 评论统计、顶级评论者和讨论模式
   • 示例："分析故事44473319的评论"

🛠️ 安装与设置

先决条件

• Node.js 18+
• npm 或 yarn

安装步骤

1. 克隆并安装：

   git clone <repository-url>
   cd hackernews-mcp-server
   npm install
   

2. 构建项目：

   npm run build
   

3. 配置MCP客户端（Cursor）：

   • .cursor/mcp.json文件已配置
   • 重启Cursor以加载MCP服务器

4. 开始使用：

   npm start
   

🎮 实际使用示例（测试并运行）

🔍 搜索帖子 - 按主题查找故事

# 我们测试了什么：
search_posts 使用查询="AI"，minScore=50，limit=10

# 我们得到的结果：
- "'Positive review only': Researchers hide AI prompts in papers" (100分，52条评论)
- "Cops in [Spain] think everyone using a Google Pixel must be a drug dealer" (65分，50条评论)

用例：

• 查找特定主题的高互动故事
• 根据作者、分数阈值或日期范围筛选
• 研究你所在领域的热门讨论

📄 获取帖子详情 - 深度故事分析

# 我们测试了什么：
get_post 对于故事ID 44473319（AI提示故事）

# 我们学到的：
- 故事的完整元数据（年龄：3.2小时，域：asia.nikkei.com）
- 完整的评论树（来自38位作者的57条评论）
- 互动指标和讨论质量

用例：

• 分析感兴趣的特定故事
• 获取完整的评论讨论
• 理解社区对新闻的反应

👤 搜索用户 - 资料分析

# 我们测试了什么：
search_user 对于"zczc"（Google Pixel故事的作者）

# 我们发现的：
- 在HN上8.6年，876 karma，持续贡献者
- 研究导向：提供原始来源
- 跨领域专长：科技、政策、编程
- 注重质量而非数量的方法

用例：

• 研究有趣帖子的作者
• 寻找领域专家和思想领袖
• 理解用户的贡献模式

📈 搜索热门 - 主题分析

# 我们测试了什么：
search_trending 分析49个当前顶级故事

# 当前趋势我们发现：
- "software"，"game"，"first"（各占6.1%）
- "systems"，"local"，"google"（各占4.1%）
- 空间技术："satellite"，"geostationary"
- 关注本地优先软件和游戏

用例：

• 追踪技术社区正在讨论的内容
• 识别新兴技术趋势
• 监控社区兴趣的变化

💬 搜索评论 - 讨论分析

# 我们测试了什么：
search_comments 在Google Pixel西班牙故事上

# 我们发现的：
- 来自38位独特作者的56条评论
- 积极讨论（多位用户有4条以上评论）
- 国际视角下的隐私/监控问题
- 高质量的审核（5条评论被删除，1条被标记）

用例：

• 分析社区对主题的看法
• 找出最活跃的讨论参与者
• 理解讨论质量和模式

🏗️ 架构

智能缓存系统

• 三级缓存：项目、用户和故事列表
• 可配置的TTL：默认5分钟，可调整
• LRU淘汰：当缓存满时自动清理
• 性能：减少API调用约80%

API客户端特性

• 全面覆盖：所有HackerNews API端点
• 批量操作：高效加载多个项目
• 错误处理：强大的重试和超时逻辑
• 速率限制：尊重API使用

增强的数据

• 故事元数据：年龄、域、评论计数计算
• 用户统计：平均分数、顶级故事、活动模式
• 评论分析：互动指标、讨论树
• 热门分析：关键词频率、主题提取

🔧 配置

环境变量（可选）：

# 服务器配置
SERVER_NAME=hackernews-mcp-server
SERVER_VERSION=1.0.0

# API配置
HACKERNEWS_API_BASE_URL=https://hacker-news.firebaseio.com/v0
HACKERNEWS_API_TIMEOUT=1_0000

# 缓存配置
CACHE_TTL_SECONDS=300
CACHE_MAX_SIZE=1000

# 日志
LOG_LEVEL=info

🧪 开发

# 开发模式带热重载
npm run dev

# 运行测试
npm test

# 代码检查
npm run lint
npm run lint:fix

# 类型检查
npm run build

📊 MCP工具及能力

你可以使用经过测试的工具做什么：

MCP工具	功能	测试中的实际例子
search_posts	按标准查找故事	发现2篇AI故事，分别有100分和65分
get_post	获取完整故事详情	分析AI提示故事，包含57条评论
search_user	资料分析	分析"zczc" - 8.6年的老用户，高质量贡献者
search_trending	主题分析	发现"software"，"game"，"systems"等热门话题
search_comments	讨论分析	分析56条评论，38位作者在Pixel故事上的讨论

资源访问模式：

• hackernews://stories/top → 当前顶级故事
• hackernews://user/username → 用户资料
• hackernews://item/12345 → 单个帖子
• hackernews://comments/12345 → 评论树

🤝 实际应用案例（基于我们的测试）

📰 内容研究与分析

• 寻找突破性的科技故事：比如我们发现的AI提示在论文中的应用（100分，活跃讨论）
• 追踪争议话题：隐私问题，如Google Pixel的用户画像故事
• 分析讨论质量：57条评论来自38位作者，显示真实的参与度
• 监控新兴趋势：空间技术、本地优先软件、游戏发展

👥 社区情报

• 识别高质量贡献者：发现"zczc"为研究导向、跨领域专家
• 理解用户模式：8.6年，稳定的karma增长，源验证习惯
• 寻找领域专家：具有持续高质量贡献的用户
• 跟踪思想领袖：特定技术领域的活跃用户

📈 趋势与情感分析

• 当前科技焦点："software"，"systems"，"game"各占6.1%
• 新兴技术：卫星/空间技术讨论增加
• 社区情感：国际隐私关注，学术诚信辩论
• 讨论模式：高质量的审核，国际视角

🔍 研究应用

• 学术研究：研究技术社区的讨论和情感
• 市场研究：了解开发者和技术社区的兴趣
• 竞争情报：监控关于技术和公司的讨论
• 内容策略：找到能产生高互动的话题

🚀 性能

• 缓存：减少API调用约80%
• 批量操作：多项目加载快3倍
• 智能过滤：客户端搜索减少服务器负载
• 并发请求：并行处理提高效率

🔒 隐私与伦理

• 仅公开数据：不访问私人信息
• 尊重使用：速率限制和缓存
• 无数据存储：临时缓存
• 透明：开源实现

🐛 故障排除

常见问题

1. 服务器无法启动

   # 检查Node.js版本
   node --version  # 应该是18+
   
   # 重新构建项目
   npm run build
   

2. MCP连接问题

   • 重启你的MCP客户端（Cursor）
   • 检查.cursor/mcp.json配置
   • 验证服务器是否运行npm start

3. API错误

   • 检查网络连接
   • 验证HackerNews API是否可访问
   • 检查缓存配置

调试模式

# 启用调试日志
LOG_LEVEL=debug npm start

# 检查缓存统计
# 使用hackernews://cache/stats资源

📈 发展路线图

• 实时WebSocket更新
• 高级情感分析
• 用户网络分析
• 导出功能
• 自定义过滤规则
• 性能仪表盘

🤝 贡献

1. 叉出仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m '添加精彩功能'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打开Pull Request

---

🎉 准备以前所未有的方式探索HackerNews吗？

🚀 快速开始命令

npm run build && npm start

💬 开始你的第一次对话

询问你的AI助手：

• "现在HackerNews上有哪些顶级AI故事？"
• "找出今天技术社区中的热门话题"
• "分析本周讨论最多的故事"

---

🙏 致谢与鸣谢

🧡 特别感谢HackerNews

"最好的技术讨论在这里发生"

我们非常感谢HackerNews和Y Combinator：

🌟 创建世界上最好的技术社区
📡 提供免费实时API访问
🔥 促进激发创新的讨论
🚀 建立每天讨论未来技术的平台

⚡ 动力来源

• 🔗 HackerNews API - 驱动一切的数据
• 🛠️ 模型上下文协议 - 使其成为可能的标准
• 💝 开源社区 - 激励我们不断建设的精神

---

📜 许可证与使用

🆓 此MCP服务器

MIT许可证 - 使用它，修改它，分享它！参见LICENSE文件。
创建者：Traves Theberge Traves.Theberge@gmail.com

📊 HackerNews API

免费用于非商业用途 - 尊重创造内容的社区。
商业用途：查看Y Combinator条款

---

🌟 加入社区

发现了一个bug？ 打开一个问题！
有一个想法？ 开始一次讨论！
想贡献？ 欢迎PR！

🔗 联系

• 📧 电子邮件：Traves.Theberge@gmail.com
• 🐙 GitHub：这个仓库
• 🗨️ 讨论：分享你的HackerNews见解！

---

<div align="center">

🧡 继续黑客，继续探索！ 🧡

为HackerNews社区而建

⭐ Star这个仓库 • 🍴 Fork它 • 📝 贡献

</div>