在本地运行 Firecrawl MCP

安装并配置本地 Firecrawl MCP 服务器。

​

前置条件

• Node.js 22 或更高版本
• Node.js 自带的 npm 和 npx
• 云端 API 所需的 Firecrawl API 密钥，或自托管 Firecrawl API 的 URL

确认已安装的 Node.js 版本：

node --version

​

通过 stdio 运行

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

这是将 MCP 服务器作为本地进程启动时客户端默认使用的传输方式。

​

使用 Streamable HTTP 运行

对于连接到已运行 MCP 服务器的 n8n 等客户端，请使用 HTTP 传输：

env HTTP_STREAMABLE_SERVER=true \
  FIRECRAWL_API_KEY=fc-YOUR_API_KEY \
  npx -y firecrawl-mcp@3.23.0

将客户端连接至：

http://localhost:3000/mcp

确认服务器已准备就绪：

curl http://localhost:3000/health

健康检查会返回 ok。本地路由为 /mcp，托管版 Firecrawl 的路由为 /v2/mcp。

​

全局安装

npm install -g firecrawl-mcp@3.23.0

然后运行：

env FIRECRAWL_API_KEY=fc-YOUR_API_KEY firecrawl-mcp

​

配置

​

环境变量

​

云端和自托管 API

• FIRECRAWL_API_KEY：你的 Firecrawl API 密钥
  • 使用云端 API (默认) 时必填
  • 使用带有 FIRECRAWL_API_URL 的自托管实例时可选
• FIRECRAWL_API_URL (可选) ：用于自托管实例的自定义 API 端点
  • 示例：https://firecrawl.your-domain.com
  • 若未提供，将使用云端 API (需要 API 密钥)

​

配置示例

使用云端 API 时：

export FIRECRAWL_API_KEY=your-api-key

对于自托管的实例：

export FIRECRAWL_API_URL=https://firecrawl.your-domain.com
export FIRECRAWL_API_KEY=your-api-key  # 如果你的实例需要鉴权

​

在 Claude Desktop 中进行自定义配置

将以下内容添加到你的 claude_desktop_config.json：

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

​

远程托管的 MCP 与本地 MCP

远程托管的 MCP 服务器针对安全的远程使用进行了优化。本地运行 MCP 服务器时可用的某些选项，在远程环境中会受到限制或不可用：

• 远程托管的免密钥模式仅开放 Search、Scrape 和解析，并按 IP 限流。
• 仅限本地的文件读取功能仅在本地运行 MCP 服务器时可用。
• 当代理需要访问本地资源时，应通过本地或自托管的 MCP 服务器配置 Webhook 和本地文件路径。

使用 firecrawl_parse 直接解析本地文件时，需要将 FIRECRAWL_API_URL 指向自托管的 Firecrawl API。仅配置云端 API 密钥的本地 MCP 服务器无法通过该工具上传本地文件。

​

限流

Firecrawl 会实施限流。使用 API 密钥可提高限额，并访问完整工具集。