firecrawl-mcp-server

环境要求

• 可用的 Node.js 环境（能运行 npx 或 npm）
• Firecrawl API Key（fc- 开头，可在 firecrawl.dev 控制台创建）
• 一个支持 MCP 的客户端：Cursor 0.45.6+、Windsurf、VS Code 或 Claude Desktop
• 可选：Docker，用于容器方式运行

安装与启动步骤

1. 1获取 API Key

   到 Firecrawl 官网控制台注册账号并创建 API Key，形如 fc-xxxxxxxx，后续所有方式都要用到。

2. 2npx 快速启动

   无需安装，直接用 npx 拉取并运行 MCP 服务器，默认使用 stdio 传输供客户端调用。

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

   复制

3. 3全局安装（可选）

   希望本地常驻安装时可全局装包，之后同样通过环境变量传入密钥启动。

   npm install -g firecrawl-mcp

   复制

4. 4Cursor 中配置

   打开 Cursor 设置 → Features → MCP Servers，添加全局 MCP 服务器并粘贴这段 JSON。

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

   复制

5. 5Windsurf 中配置

   把同样的 mcpServers 结构写入 Windsurf 的 model_config.json，键名可自定。

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

   复制

6. 6VS Code 中配置

   按 Ctrl+Shift+P 打开用户设置 JSON，填入 mcp 配置；API Key 用输入框提示方式录入更安全。

   {
     "mcp": {
       "inputs": [
         {
           "type": "promptString",
           "id": "apiKey",
           "description": "Firecrawl API Key",
           "password": true
         }
       ],
       "servers": {
         "firecrawl": {
           "command": "npx",
           "args": ["-y", "firecrawl-mcp"],
           "env": {
             "FIRECRAWL_API_KEY": "${input:apiKey}"
           }
         }
       }
     }
   }

   复制

7. 7本地 HTTP 模式

   改用 Streamable HTTP 传输而非 stdio，启动后监听 3000 端口，供客户端用 URL 连接。

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

   复制

8. 8Docker 方式运行

   用官方镜像以 HTTP 模式运行，示例只把端口绑定到 127.0.0.1，避免带密钥的服务暴露出去。

   docker run --rm -p 127.0.0.1:3000:3000 
     -e HTTP_STREAMABLE_SERVER=true 
     -e FIRECRAWL_API_KEY=fc-YOUR_API_KEY 
     ghcr.io/firecrawl/firecrawl-mcp-server:latest

   复制

关键配置

如何确认成功

客户端 MCP 服务器列表中出现 firecrawl-mcp 及其工具即成功；HTTP 模式可访问 http://localhost:3000/mcp 确认服务在线。

常见问题

注意事项

• HTTP 模式示例只发布到 127.0.0.1，因为容器会用自身密钥代发请求，不要随意放宽端口暴露范围。
• 容器以内置的非特权 node 用户运行，挂载目录时注意文件权限。
• Cursor 需 0.45.6 及以上版本，不同小版本的添加方式略有差异，按界面提示操作。
• 修改 mcpServers 配置后需刷新客户端 MCP 服务器列表才能看到新工具。