JinDaGe - mcp-claude-hackernews MCP Details

article

README

🚀 MCP Claude 与 Hacker News 集成指南

本指南旨在详细介绍如何在 MCP（Model Context Protocol）Claude 中集成和使用来自 Hacker News 的数据。借助本指南，您能够从 Claude Desktop 中访问、查询并分析 Hacker News 平台上的最新故事、热门内容及评论。

🚀 快速开始

若想快速开启 MCP Claude 与 Hacker News 的集成之旅，可按照以下步骤操作：

下载并安装 MCP 库。
安装必要的依赖项。
初始化 MCP 项目。
创建启动脚本。
完成配置文件的创建与修改。
启动 MCP 服务并开始查询 Hacker News 数据。

✨ 主要特性

可直接从 Claude Desktop 访问 Hacker News 平台上的最新故事、热门内容及评论。
支持通过命令行和自然语言进行数据查询。
能够对查询结果的最大数量和默认类别进行配置。

📦 安装指南

1. 下载 MCP 库

在终端运行以下命令，下载并安装 MCP 库：

npm install mcp-claudie

2. 安装依赖项

确保已安装 Node.js 和 npm，然后运行以下命令安装必要的依赖项：

npm install hacker-news-api

3. 初始化 MCP 项目

在项目目录中创建一个 mcp-config.json 文件，并添加以下内容：

{
  "services": {
    "hacker-news": {
      "type": "api",
      "endpoint": "https://hn.algolia.com/api/v1"
    }
  },
  "scripts": {
    "start": "node index.js"
  }
}

4. 创建启动脚本

根据操作系统创建相应的启动脚本：

Windows

在 C:\Users\%username%\AppData\Roaming\Microsoft\Windows\Start Menu 中创建一个新的快捷方式，选择目标位置为：

node.exe C:\path\to\your\project\index.js

macOS/Linux

在 /usr/local/bin 目录下创建一个名为 mcp-hackernews 的可执行文件，并添加以下内容：

#!/bin/bash
cd /path/to/your/project && node index.js

确保文件具有可执行权限：

chmod +x /usr/local/bin/mcp-hackernews

📚 详细文档

配置指南

1. 创建配置文件

在项目根目录中创建一个 config.json 文件，并添加以下内容：

{
  "api_key": "your_hacker_news_api_key",
  "max_results": 50,
  "default_category": "programming"
}

2. 修改配置文件

可根据需求修改配置文件。例如，若想限制每次查询的最大结果数，可调整 max_results 的值。

使用指南

1. 启动 MCP 服务

在终端运行以下命令启动 MCP 服务：

npm start

2. 查询 Hacker News 数据

通过以下命令从 Claude Desktop 中查询 Hacker News 数据：

获取最新故事：

hn latest --50

获取热门故事：

hn top --20

获取最佳故事：

hn best --30

获取特定故事的详细信息：

hn history --12345678

获取评论：

hn comments --3 或 hn comments --12345678

3. 使用自然语言查询

也可通过自然语言与 MCP 进行交互，例如：

"显示今天 Hacker News 上的前 30 个最佳故事"
"列出编程类别下的最新新闻"

故障排除

1. 确保 API 密钥有效

检查 config.json 文件，确保 api_key 有效。可在 Hacker News API 文档中获取 API 密钥。

2. 检查网络连接

若无法连接到 Hacker News 服务，请确保设备已连接互联网，且防火墙未阻止相关端口。

3. 查看错误日志

在终端查看 MCP 的输出日志，以获取更多问题详细信息：

npm run debug

贡献指南

1. 提交代码

可通过提交拉取请求为本项目贡献代码，请确保代码符合项目的编码规范。

2. 创建功能请求

若有任何功能需求或改进建议，请在 GitHub 仓库中创建一个新问题。

📄 许可证

此项目遵循 MIT License，您可在 LICENSE 文件中找到完整的许可信息。

mcp-claude-hackernews