mcpField
F
Firecrawl Server for MCP

Firecrawl Server for MCP

Local
github.com/radu103Browser Automation1Updated 80w ago
Repository

About Firecrawl Server for MCP

Firecrawl Server for MCP is an Express API server for scraping URLs and crawling websites. It is intended for applications that need single-page, batch, or whole-site extraction through HTTP endpoints.

Key features

  1. 01Scrape a single URL
  2. 02Scrape multiple URLs in a batch
  3. 03Crawl and scrape all pages of a website
  4. 04HTTP endpoints for scraping and crawling

Use cases

  1. 01Extract content from one web page
  2. 02Process a list of URLs together
  3. 03Collect pages across a website
  4. 04Run the API using Docker Compose
#firecrawl#web-crawling#scraping

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "firecrawl-server-for": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "compose"
      ]
    }
  }
}
Run commanddocker run -i --rm compose

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocicompose

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Firecrawl Server for MCP

Express API server for Firecrawl that provides endpoints for web crawling and scraping functionality.

Features

  • Scrape a single URL
  • Scrape multiple URLs in batch
  • Crawl a website and scrape all pages

Docker Setup

This project can be easily run using Docker and Docker Compose. Docker Compose allows you to define, manage, and run multi-container Docker applications with ease.

Prerequisites
Docker Compose Commands
Build and Start the Container
# Build and start in detached mode
docker compose up -d

# Build the image without starting the container
docker compose build

# Build with no cache (force rebuild)
docker compose build --no-cache

# Build and start with logs in console (not detached)
docker compose up
Manage the Container
# Stop the container
docker compose stop

# Stop and remove the container
docker compose down

# Stop and remove the container and volumes
docker compose down -v

# View container logs
docker compose logs

# Follow container logs
docker compose logs -f

# Restart the container
docker compose restart
Scaling (if needed)
# Scale the service to multiple instances
docker compose up -d --scale firecrawl-server=3
Tag and upload

docker tag firecrawl-server-for-mcp-tools yourusername/firecrawl-server-for-mcp:latest docker tag firecrawl-server-for-mcp-tools yourusername/firecrawl-server-for-mcp:0.0.1 docker push radu103/firecrawl-server-for-mcp:latest docker push radu103/firecrawl-server-for-mcp:0.0.1

Docker Compose File

The project includes a docker-compose.yml file that configures:

  • Port mapping (3000:3000)
  • Environment variables
  • Volume for persistent storage of downloaded files

API Endpoints

  • GET /: Home route that displays API information
  • POST /scrape: Scrape a single URL
  • POST /scrape-batch: Scrape multiple URLs
  • POST /crawl: Crawl a website and scrape all pages

Sample Requests

Check the sample_requests directory for HTTP request examples.

Development

Installation Without Docker
# Install dependencies
npm install

# Start server
npm start

The server runs on port 3000 by default or the port specified in the PORT environment variable.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.