Which integrations are available for this server?

The server extracts and converts web content from single pages or entire websites into Markdown format, specifically designed for use with LLMs and other markdown-compatible tools.

How do I use Firecrawl Local MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Firecrawl Local MCP crawl https://docs.stripe.com with a depth of 2" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Firecrawl Local MCP Server

An MCP (Model Context Protocol) server for interacting with a self-hosted Firecrawl instance. This server provides web scraping and crawling capabilities through your local Firecrawl deployment.

Features

Web Scraping: Extract content from single web pages in markdown format
Web Crawling: Crawl entire websites with customizable depth and filtering
Site Mapping: Generate lists of all accessible URLs on a website
Job Monitoring: Track the status of crawling jobs
No API Key Required: Works directly with self-hosted Firecrawl instances

Installation

npm install npm run build

Configuration

The server connects to your Firecrawl instance using the FIRECRAWL_URL environment variable. By default, it connects to http://localhost:3002.

To change the Firecrawl URL, set the FIRECRAWL_URL environment variable in your MCP configuration.

Usage

With Claude Desktop

Add this to your Claude Desktop configuration file (claude_desktop_config.json):

{ "mcpServers": { "firecrawl-local": { "command": "node", "args": ["/absolute/path/to/firecrawl-local-mcp/dist/index.js"], "env": { "FIRECRAWL_URL": "http://localhost:3002" } } } }

With Cline

Add this to your Cline MCP configuration file:

{ "mcpServers": { "firecrawl-local": { "command": "node", "args": ["dist/index.js"], "cwd": "/absolute/path/to/firecrawl-local-mcp", "env": { "FIRECRAWL_URL": "http://localhost:3002" } } } }

Available Tools

firecrawl_scrape

Scrape a single webpage and return its content in markdown format.

Parameters:

url (required): The URL to scrape
formats: Output formats (default: ["markdown"])
onlyMainContent: Extract only main content (default: true)
includeTags: HTML tags to include
excludeTags: HTML tags to exclude

firecrawl_crawl

Crawl a website starting from a URL and return content from multiple pages.

Parameters:

url (required): The starting URL to crawl
includes: URL patterns to include (supports wildcards)
excludes: URL patterns to exclude (supports wildcards)
maxDepth: Maximum crawl depth (default: 2)
limit: Maximum number of pages to crawl (default: 10)
allowBackwardLinks: Allow crawling backward links (default: false)
allowExternalLinks: Allow crawling external links (default: false)

firecrawl_crawl_status

Check the status of a crawl job.

Parameters:

jobId (required): The job ID returned from a crawl request

firecrawl_map

Map a website to get a list of all accessible URLs.

Parameters:

url (required): The URL to map
search: Search query to filter URLs
ignoreSitemap: Ignore the website's sitemap (default: false)
includeSubdomains: Include subdomains (default: false)
limit: Maximum number of URLs to return (default: 5000)

Testing

Test the server functionality:

node test.js

This will test both the tool listing and a sample scrape operation.

Example Usage

Once configured in Claude Desktop, you can use natural language commands like:

"Scrape the content from https://example.com"
"Crawl the documentation site at https://docs.example.com with a depth of 3"
"Map all the URLs on https://example.com"
"Check the status of crawl job abc123"

Requirements

Node.js 18+
A running Firecrawl self-hosted instance (see Firecrawl Self-Hosting Guide)
Network access to the Firecrawl instance

Troubleshooting

Connection Issues: Verify your Firecrawl instance is running and accessible
Timeout Errors: Adjust timeout values in src/index.ts for slow websites
Authentication Errors: Ensure USE_DB_AUTHENTICATION=false in your Firecrawl .env file