Skip to main content
Firecrawl Docs

在本地运行 Firecrawl MCP

通过 stdio 或 Streamable HTTP 启动并配置开源 Firecrawl MCP 服务器。
1 min read

当客户端需要启动本地进程、需要使用本地 HTTP 传输，或 MCP 服务器必须连接自托管 Firecrawl API 时，请在本地运行 Firecrawl MCP。对于托管服务，请从开始使用开始。

前置条件#

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

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

启动服务器#

当 MCP 客户端以本地进程方式启动 Firecrawl 时，使用 stdio：

将客户端配置为运行 npx -y firecrawl-mcp@3.23.7，并通过客户端的受保护环境变量或密钥机制提供 FIRECRAWL_API_KEY。

配置 Firecrawl API#

环境变量用途
FIRECRAWL_API_KEY用于向 Firecrawl 云端 API 进行身份验证。只有在自托管 API 无需身份验证时，该变量才是可选的。
FIRECRAWL_API_URL将请求发送至自托管 Firecrawl API，而不是云端 API。
HTTP_STREAMABLE_SERVER设为 true 可启动本地 Streamable HTTP 传输，而非 stdio。
Note

使用 firecrawl_parse 直接解析本地文件时，FIRECRAWL_API_URL 必须指向自托管 Firecrawl API。仅连接云端 API 的本地 MCP 服务器无法通过该工具上传本地文件；托管服务器则使用签名上传交接。

全局安装#

使用 npx 可快速完成设置。如需全局安装同一经过审核的版本：

然后运行：

故障排除#

客户端报错 spawn npx ENOENT

安装 Node.js 22 或更高版本，确认客户端的 PATH 中包含 npx，然后彻底重启客户端。在 Windows 上，请在命令提示符中运行 where npx，并将客户端配置为使用返回的 npx.cmd 路径。

HTTP 客户端无法连接

确认已设置 HTTP_STREAMABLE_SERVER=true，然后访问 http://localhost:3000/health。客户端端点应使用 http://localhost:3000/mcp，而非托管的 /v2/mcp 路径。

工具不可用

工具是否可用取决于目标部署中启用的 Firecrawl 服务。请对照工具检查连接，并查看本地进程输出中是否有注册或身份验证错误。

服务器已被限流

限流由所连接的 Firecrawl API 执行。请查看当前的限流以及自托管部署配置的限制。