项目简介

本项目是一个实现了 Model Context Protocol (MCP) 的服务器，旨在为大型语言模型 (LLM) 提供访问 Hacker News 资讯和进行网页内容抓取的能力。通过集成此服务器，LLM客户端可以调用预设的工具来获取最新的 Hacker News 讨论、搜索相关主题，以及提取任何网页的文本内容，从而增强LLM在信息获取和处理方面的能力。

主要功能点

Hacker News 资讯访问: 提供工具检索 Hacker News 上的热门讨论和特定条目的详细信息。
网页内容抓取: 集成 Firecrawl API，允许 LLM 抓取并提取任何指定 URL 的网页内容，并以 Markdown 格式返回，方便 LLM 理解和处理。
Hacker News 内容搜索: 支持通过关键词在 Hacker News 上进行内容搜索，帮助 LLM 快速找到相关讨论。
易于集成: 遵循 MCP 协议标准，可以方便地与任何支持 MCP 协议的 LLM 客户端集成。

安装步骤

克隆仓库: 将 GitHub 仓库 'firecrawl-mcp-example' 克隆到本地。

安装依赖: 使用 UV 包管理器安装项目依赖。首先确保已安装 UV，然后在仓库根目录下执行以下命令：

uv venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate   # Windows
uv install -e .

配置 Firecrawl API 密钥: 在仓库根目录下创建 '.env' 文件，并添加您的 Firecrawl API 密钥：
```
FIRECRAWL_API_KEY=YOUR_API_KEY_HERE
```
请替换 'YOUR_API_KEY_HERE' 为您实际的 Firecrawl API 密钥。

服务器配置

要将此 MCP 服务器配置到 MCP 客户端，您需要提供以下 JSON 格式的配置信息。例如，在 Claude Desktop 客户端中配置：

{
  "serverName": "hn-firecrawl-service",
  "command": "uv",
  "args": ["run", "server.py"]
}

配置参数说明：

'serverName': 服务器名称，这里设置为 'hn-firecrawl-service'，用于在客户端中标识该服务器。
'command': 启动服务器的命令。由于项目使用了 'uv run server.py' 启动服务器，因此设置为 'uv'。
'args': 传递给启动命令的参数，这里使用 '["run", "server.py"]' 来运行 'server.py' 脚本。

基本使用方法

启动服务器: 在安装并配置完成后，在仓库根目录下运行以下命令启动 MCP 服务器：
```
uv run server.py
```
配置 MCP 客户端: 在您的 MCP 客户端（如 Claude Desktop）中，根据客户端的指引添加新的 MCP 服务器，并将上面提供的 JSON 配置信息填入客户端。
使用工具: 成功连接到 MCP 服务器后，您可以在 LLM 客户端中使用以下工具，通过自然语言指令调用：
- 'get_hnews_item': 获取指定 Hacker News 条目 ID 的详细信息。
- 'get_hnews_popular_discussions': 获取 Hacker News 今日热门讨论列表。
- 'firecrawl_scrape_url': 抓取指定 URL 的网页内容。
- 'search_hnews': 在 Hacker News 上搜索相关主题的讨论。

例如，在 Claude 中，您可以提问类似 “使用 'get_hnews_popular_discussions' 工具获取今天 Hacker News 的热门讨论” 或 “使用 'firecrawl_scrape_url' 工具抓取 'https://example.com' 的内容” 的指令。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息