Firecrawl MCP Server

一个 MCP（模型上下文协议）服务器，将 Firecrawl 引入兼容 MCP 的 AI 代理——搜索、抓取并与实时网页交互，以获取干净、可直接供代理使用的上下文。

衷心感谢 @vrknetha 和 @knacklabs 的初始实现！

功能特性

• 搜索网页并获取完整页面内容
• 搜索为编码代理构建的索引：GitHub issues、已合并的 pull request、README 和文档
• 将任意 URL 抓取为干净、结构化的数据
• 与页面交互——点击、导航和操作
• 使用自主代理进行深度研究
• 自动重试和速率限制
• 支持云托管和自托管
• 支持 SSE

可以在 MCP.so 的 playground 或 Klavis AI 上试用我们的 MCP 服务器。

安装

托管 MCP（无密钥免费层）

无需任何配置即可连接远程托管服务器：

https://mcp.firecrawl.dev/v2/mcp

在无密钥免费层中，scrape、search 和 parse 无需 API 密钥即可使用（有限速）。其他工具（如 crawl、map 和 agent）仍需要密钥。

只要用户可以注册账号，建议优先使用 OAuth 或 API 密钥。这样可以解锁完整的工具集和更高的限额。

对于交互式账号连接，请将 MCP 客户端配置为使用此服务器 URL。这是一个 MCP 端点，不是浏览器页面；请使用客户端的账号连接流程，重新连接时不要重复添加 Firecrawl 服务器条目：

https://mcp.firecrawl.dev/v2/mcp-oauth

对于 API 密钥连接（例如无人值守的集成），请将服务器 URL 保持为：

https://mcp.firecrawl.dev/v2/mcp

然后使用以下内容配置客户端的安全请求头或密钥设置：

Authorization: Bearer <FIRECRAWL_API_KEY>

切勿将 API 密钥放在服务器 URL 中，也切勿将 API 密钥放在代理对话中。请直接在客户端或密钥管理器中配置。有关针对具体客户端的说明，请参阅托管 MCP 设置指南和代理入门指南。

仅搜索端点

另外还托管了一个只读、仅搜索的端点：

https://mcp.firecrawl.dev/v2/mcp-search

它暴露一组固定的六个只读工具：firecrawl_search 和五个 firecrawl_research_* 工具。它不执行任何页面内容抓取，并且拥有自己的 OAuth 身份；上面的完整端点保持不变。完整契约请参阅 docs/search-profile.md。

使用 npx 运行

env FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp

手动安装

npm install -g firecrawl-mcp

在 Cursor 上运行

配置 Cursor 🖥️

注意：需要 Cursor 0.45.6 或更高版本。有关最新的配置说明，请参阅 Cursor 官方文档中关于配置 MCP 服务器的内容：Cursor MCP 服务器配置指南

在 Cursor v0.48.6 中配置 Firecrawl MCP：

1. 打开 Cursor 设置
2. 进入 Features > MCP Servers
3. 点击“+ Add new global MCP server”
4. 输入以下代码：

   {
     "mcpServers": {
       "firecrawl-mcp": {
         "command": "npx",
         "args": ["-y", "firecrawl-mcp"],
         "env": {
           "FIRECRAWL_API_KEY": "YOUR-API-KEY"
         }
       }
     }
   }
   

在 Cursor v0.45.6 中配置 Firecrawl MCP：

1. 打开 Cursor 设置
2. 进入 Features > MCP Servers
3. 点击“+ Add New MCP Server”
4. 输入以下内容：
   • 名称：“firecrawl-mcp”（或你喜欢的名称）
   • 类型：“command”
   • 命令：env FIRECRAWL_API_KEY=your-api-key npx -y firecrawl-mcp

如果你使用的是 Windows 并且遇到问题，请尝试 cmd /c "set FIRECRAWL_API_KEY=your-api-key && npx -y firecrawl-mcp"

将 your-api-key 替换为你的 Firecrawl API 密钥。如果还没有密钥，可以注册账号并从 https://www.firecrawl.dev/app/api-keys 获取。

添加后，刷新 MCP 服务器列表即可看到新工具。Composer Agent 会在适当时自动使用 Firecrawl MCP，你也可以通过描述网页抓取需求来显式调用它。通过 Command+L（Mac）打开 Composer，在提交按钮旁选择“Agent”，然后输入你的查询。

在 Windsurf 上运行

将以下内容添加到你的 ./codeium/windsurf/model_config.json：

{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

使用 Streamable HTTP 本地模式运行

要使用 Streamable HTTP 运行服务器……