快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

python --version

详细介绍

Hacker News MCP 服务器

一个提供Hacker News API访问的模型上下文协议（MCP）服务器。此服务器允许像Claude这样的AI助手从Hacker News获取故事、评论、用户资料和其他内容。

使用Claude技能mcp-builder通过Claude Code创建。

特点

9款综合工具 用于访问Hacker News数据：

- hn_get_item - 通过ID获取任意项目（故事、评论、工作、调查） - hn_get_top_stories - 获取当前首页的新闻故事 - hn_get_new_stories - 获取最新故事 - hn_get_best_stories - 获取有史以来最棒的故事 - hn_get_ask_stories - 获取Ask HN帖子 - hn_get_show_stories - 获取Show HN帖子 - hn_get_job_stories - 获取职位招聘信息 - hn_get_user - 获取用户资料信息 - hn_get_max_item_id - 获取最新的项目ID

灵活的输出格式Markdown（人类可读）和JSON（机器可读）两者都支持

分页支持高效浏览大型结果集

细节级别选择简洁的总结或详细的信息

速率限制处理优雅的错误处理，附带有用的信息

字符限制对大型响应进行自动截断

并行获取高效批量请求多个项目

要求

Python 3.8或更高版本 （在 Python 3.10+ 上测试）
Windows 10/11 （兼容 PowerShell 和 Git Bash）

安装

第一步：安装Python

如果你还没有安装Python：

从（某处）下载Python python.org
重要的在安装过程中，勾选“将 Python 添加到 PATH”
验证安装：

   python --version

步骤2：创建虚拟环境（推荐）

使用虚拟环境可以保持依赖项的隔离：

PowerShell：

cd /path/to/claude_skill_create_hn_mcp_server
python -m venv venv
.\venv\Scripts\Activate.ps1

Git Bash：

cd /path/to/claude_skill_create_hn_mcp_server
python -m venv venv
source venv/Scripts/activate

你应该看到 (venv) 激活后，在您的终端提示符下。

步骤3：安装依赖项

pip install --upgrade pip
pip install mcp httpx pydantic

验证安装：

python -c "from mcp.server.fastmcp import FastMCP; print('MCP installed successfully')"

步骤4：测试服务器

验证服务器能否运行：

python hackernews_mcp.py --help

你应该能看到FastMCP的帮助输出。服务器可能会看起来卡住——这是正常的！按下 Ctrl+C 阻止它。

配置

对于Claude Desktop（Windows版）

找到您的Claude Desktop配置文件：

   %APPDATA%\Claude\claude_desktop_config.json

在文本编辑器中打开它，并添加Hacker News MCP服务器：

PowerShell 用户：

{
  "mcpServers": {
    "hackernews": {
      "command": "/path/to/python.exe",
      "args": [
        "/path/to/hackernews_mcp.py"
      ]
    }
  }
}

Git Bash 用户：

{
  "mcpServers": {
    "hackernews": {
      "command": "/path/to/python.exe",
      "args": [
        "/path/to/hackernews_mcp.py"
      ]
    }
  }
}

重要提示：

使用双反斜杠（\\在JSON文件路径中（有）)
使用两个文件的完整绝对路径 python.exe 和 hackernews_mcp.py
如果您有其他MCP服务器，请将此作为另一项条目添加进去 mcpServers

重启Claude桌面版

验证连接：

- 打开Claude桌面版 - 寻找“锤子”或“工具”图标，表示MCP服务器已连接 - 问Claude：“你有哪些可用的Hacker News工具？”

对于其他MCP客户端

服务器默认使用stdio传输方式。请配置您的MCP客户端以运行：

python /path/to/hackernews_mcp.py

使用示例

配置完成后，您可以要求Claude使用Hacker News工具：

获取头条新闻

Show me the top 10 stories on Hacker News right now

获取故事详情

Get details about HN story with ID 8863

搜索用户

What's the profile for HN user 'pg'?

获取 Ask HN 帖子

Show me the latest Ask HN questions with at least 50 comments

浏览职位发布

What are the latest 5 job postings on HN?

工具参考

\`hn_get_item\` 翻译成中文可以是“获取项目/条目”。不过，具体的翻译可能还需要根据上下文来确定，因为“hn”可能是一个特定系统或应用的缩写，而“get_item”通常表示获取某个项目或条目的操作。在没有具体上下文的情况下，“获取项目/条目”是一个比较通用的翻译

获取任何HN项目（故事、评论、工作、投票）的完整详情。

参数：

item_id （必填）：物品ID编号
response_format“markdown”（默认）或“json”
detail_level“详细”（默认）或“简洁”

示例：

{
  "item_id": 8863,
  "response_format": "markdown",
  "detail_level": "detailed"
}

获取热门故事

获取当前首页的新闻故事。

参数：

limit返回的最大故事数（1-100，默认：30）
offset跳过这么多故事（默认：0）
response_format“markdown”（默认）或“json”
detail_level“简洁”（默认）或“详细”