内容
# 🔥 FireScrape MCP 服务器
<div align="center">
**AI 代理的终极网关。**
*赋予您的 LLMs 精确浏览、搜索、研究和抓取的能力。*
[安装](#-安装--使用) • [连接指南](#-连接指南) • [AI 规则](#-ai-代理规则) • [工具](#%EF%B8%8F-工具参考)
</div>
---
## 🚀 概述
**FireScrape MCP** 是一个模型上下文协议服务器，旨在弥合 AI 模型（Claude、Cursor 等）与现实世界之间的差距。它提供了强大的工具，用于：
* **深度研究：** 进行复杂主题的多步骤自主调查和综合。
* **网络访问：** 防阻塞搜索和智能 Markdown 抓取。
* **本地上下文：** 文件系统访问，用于项目感知编码。
## 📦 安装与使用
使用 `npx` 无需全局安装即可运行：
```bash
npx -y @yutugyutugyutug/firescrape-mcp
```
### ✨ 主要功能（v1.1.2）
* 🧠 **`deep_research`**：对复杂主题进行自主、多步骤的研究，过滤噪音并综合报告。
* 🌐 **`search_web`**：高可用性网络搜索，带有备用提供商（DuckDuckGo + Brave），确保始终获取结果。
* 📄 **`scrape_webpage`**：将杂乱的 HTML 转换为干净、令牌高效的 Markdown，去除广告和不相关的样板。
* 🔍 **`discover_tools`**：一个“元工具”，用于从 GitHub 和 Smithery 查找和安装其他 MCP 服务器。
* 📂 **本地集成**：无缝 `list_files` 和 `read_file`，为 AI 提供有关本地项目的上下文。
---
## 🤖 AI 代理规则
**让您的 AI 更智能？**
我们创建了一套标准化的规则集，用于教导 AI 代理（Cursor、Windsurf、Cline）如何有效使用这些工具来验证事实和避免幻觉。
👉 **[阅读 AI 使用指南](./rules/AI_USAGE_RULES.md)**
*将上面的文件内容复制到您的 `.cursorrules` 或系统提示中，以增强您的代理。*
---
## 🔌 连接指南
### 1. Claude 桌面应用程序
1. 打开配置文件：
* **Windows:** `Win + R` -> `%APPDATA%\Claude\claude_desktop_config.json`
* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
2. 添加此配置：
```json
{
"mcpServers": {
"firescrape": {
"command": "npx",
"args": ["-y", "@yutugyutugyutug/firescrape-mcp"]
}
}
}
```
### 2. Cursor（AI 代码编辑器）
1. 导航到 **设置** -> **功能** -> **MCP**。
2. 点击 **+ 添加新 MCP 服务器**。
3. 填写字段：
* **名称：** `FireScrape`
* **类型：** `stdio`
* **命令：** `npx`
* **参数：** `-y @yutugyutugyutug/firescrape-mcp`
4. 点击 **添加** 保存。
### 3. Gemini CLI
1. 找到配置文件：
* **Linux/Mac:** `~/.gemini/settings.json`
* **Windows:** `%USERPROFILE%\.gemini\settings.json`
2. 插入服务器配置：
```json
{
"mcpServers": {
"firescrape": {
"command": "npx",
"args": ["-y", "@yutugyutugyutug/firescrape-mcp"]
}
}
}
```
### 4. Claude Code（CLI）
在终端中运行此命令以添加 FireScrape：
```bash
claude mcp add firescrape -- npx -y @yutugyutugyutug/firescrape-mcp
```
### 5. Google Antigravity
1. 打开 **管理 MCP 服务器** 面板。
2. 选择 **"编辑配置"** 或打开 `mcp_config.json`。
3. 添加条目：
```json
"firescrape": {
"command": "npx",
"args": ["-y", "@yutugyutugyutug/firescrape-mcp"]
}
```
### 6. Cline（VS Code 扩展）
1. 打开 **Cline 设置**（在 VS Code 设置中或通过扩展菜单）。
2. 找到 **MCP 服务器** 配置文件（通常通过按钮“编辑 MCP 设置”）。
3. 添加以下内容：
```json
{
"mcpServers": {
"firescrape": {
"command": "npx",
"args": ["-y", "@yutugyutugyutug/firescrape-mcp"]
}
}
}
```
---
## 🛠️ 工具参考
| 工具名称 | 描述 | 参数 |
| :--- | :--- | :--- |
| `scrape_webpage` | 读取特定 URL 并返回结构化 Markdown。 | `url`（字符串） |
| `search_web` | 在网络上查找当前信息。 | `query`（字符串） |
| `discover_tools` | 查找 GitHub 上的其他 MCP 服务器。 | `query`（字符串） |
| `search_in_page` | 在特定页面 URL 中搜索文本。 | `url`（字符串），`query`（字符串） |
| `list_files` | 列出文件夹中的文件。 | `path`（字符串，可选） |
| `read_file` | 读取文件的内容。 | `path`（字符串） |
| `get_agent_rules` | 返回 AI 代理的严格操作协议。 | `(无)` |
---
<div align="center">
由 <a href="https://github.com/aasm3535/firescrape">FireScrape</a> 用 ❤️ 构建
</div>
