【亲测免费】 Firecrawl MCP Server 使用教程

1. 项目目录结构及介绍

Firecrawl MCP Server 的项目目录结构如下：

firecrawl-mcp-server/
├── .github/
│   └── workflows/
├── src/
│   ├── .eslintrc.json
│   ├── .gitignore
│   ├── .prettierrc
│   ├── Dockerfile
│   ├── LICENSE
│   ├── README.md
│   ├── jest.config.js
│   ├── jest.setup.ts
│   ├── package-lock.json
│   ├── package.json
│   ├── pnpm-lock.yaml
│   ├── smithery.yaml
│   └── tsconfig.json

• .github/workflows/: 存放 GitHub Actions 工作流文件，用于自动化构建、测试等流程。
• src/: 源代码目录，包含项目的所有代码和配置文件。
  • .eslintrc.json: ESLint 配置文件，用于定义代码风格和语法规则。
  • .gitignore: Git 忽略文件，用于指定 Git 忽略的文件和目录。
  • .prettierrc: Prettier 配置文件，用于定义代码格式化规则。
  • Dockerfile: Docker 构建文件，用于构建项目的 Docker 容器镜像。
  • LICENSE: 项目许可证文件，本项目采用 MIT 许可证。
  • README.md: 项目说明文件，包含项目的介绍、功能和使用说明。
  • jest.config.js: Jest 测试框架配置文件。
  • jest.setup.ts: Jest 测试框架设置文件。
  • package-lock.json: npm 包锁定文件，用于确保安装的依赖版本一致。
  • package.json: npm 包配置文件，定义项目依赖、脚本和元数据。
  • pnpm-lock.yaml: pnpm 包管理器锁定文件。
  • smithery.yaml: Smithery 配置文件，用于自动化项目构建等。

2. 项目的启动文件介绍

项目的启动主要通过 package.json 中的 scripts 字段定义的脚本进行。以下是 package.json 中的相关部分：

"scripts": {
  "start": "node src/index.js"
}

• "start": 用于启动项目的脚本。执行 npm start 或 yarn start 时，会运行 node src/index.js 命令，启动 Node.js 服务器。

3. 项目的配置文件介绍

项目的配置主要通过环境变量和配置文件进行。以下是项目中的配置文件和相关的环境变量：

• src/config.js: 配置文件，定义了项目的默认配置，如下：

const CONFIG = {
  retry: {
    maxAttempts: 3,
    initialDelay: 1000,
    maxDelay: 10000,
    backoffFactor: 2
  },
  credit: {
    warningThreshold: 1000,
    criticalThreshold: 100
  }
};

• 环境变量：项目支持通过环境变量覆盖 config.js 中的默认配置。以下是一些常用的环境变量：

export FIRECRAWL_API_KEY=your-api-key
export FIRECRAWL_RETRY_MAX_ATTEMPTS=5
export FIRECRAWL_RETRY_INITIAL_DELAY=2000
export FIRECRAWL_RETRY_MAX_DELAY=30000
export FIRECRAWL_RETRY_BACKOFF_FACTOR=3
export FIRECRAWL_CREDIT_WARNING_THRESHOLD=2000
export FIRECRAWL_CREDIT_CRITICAL_THRESHOLD=500

以上是关于 Firecrawl MCP Server 的基本介绍和配置说明。要开始使用这个项目，你需要首先设置环境变量，然后运行 npm start 来启动服务器。