在本地运行 Firecrawl MCP

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

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

node --version

env FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y [email protected]

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

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

env HTTP_STREAMABLE_SERVER=true \
  FIRECRAWL_API_KEY=fc-YOUR_API_KEY \
  npx -y [email protected]

将客户端连接至：

http://localhost:3000/mcp

确认服务器已准备就绪：

curl http://localhost:3000/health

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

npm install -g [email protected]

然后运行：

env FIRECRAWL_API_KEY=fc-YOUR_API_KEY firecrawl-mcp

• 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_config.json：

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

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

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

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