🔥 Firecrawl MCP-Server

Bedienen Sie eine selbst gehostete Firecrawl-Instanz von Claude aus über MCP.

LP: daisukehori.github.io/firecrawl-mcp

Sie können eine selbst gehostete Firecrawl-Instanz direkt über MCP (Model Context Protocol) von Claude.ai / Claude Desktop / Claude Code aus steuern.

Enthält 11 Tools für Websuche, Einzel-/Batch-Scraping, Site-Crawling, Sitemap-Abruf und LLM-strukturierte Extraktion.

Architektur

Claude.ai ──MCP──▶ Vercel (firecrawl-mcp)
                        │
                        ▼
               Firecrawl (self-hosted)
               your-firecrawl.example.com

Eine Next.js-App auf Vercel verarbeitet das MCP-Protokoll und leitet Anfragen an die API der selbst gehosteten Firecrawl-Instanz weiter. Der Server ist zustandslos (stateless) und speichert weder Daten noch Logs.

Related MCP server: Firecrawl MCP Server

Tool-Übersicht (11 Tools)

Scraping

Crawling

Suche, Mapping & Extraktion

Quickstart (3 Schritte)

Schritt 1: Selbst gehostete Firecrawl-Instanz vorbereiten

Starten Sie Firecrawl gemäß dem Firecrawl Self-Host Guide.

git clone https://github.com/mendableai/firecrawl.git
cd firecrawl
docker compose up -d

Standardmäßig startet es unter http://localhost:3002.

Schritt 2: MCP-Server bereitstellen

One-Click-Deployment (Empfohlen)

Manuelle Bereitstellung

git clone https://github.com/DaisukeHori/firecrawl-mcp.git
cd firecrawl-mcp
cp .env.example .env.local
# .env.local を編集
npm install
npm run dev

Schritt 3: Verbindung von Claude aus

Claude.ai (Web): Settings → MCP → Add:

• URL: https://your-firecrawl-mcp.vercel.app/api/mcp

• Header-Name: x-api-key Wert: Ihr_MCP_API_KEY

Claude Desktop / Cursor / VS Code / Windsurf:

{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://your-firecrawl-mcp.vercel.app/api/mcp"],
      "env": {
        "HEADER_x-api-key": "あなたのMCP_API_KEY"
      }
    }
  }
}

Claude Code:

claude mcp add --transport http firecrawl https://your-firecrawl-mcp.vercel.app/api/mcp \
  --header "x-api-key: あなたのMCP_API_KEY"

Umgebungsvariablen

Anwendungsbeispiele

ユーザー: 「docs.firecrawl.dev の全ページをMarkdownで取得して」

AI: まずサイトマップを確認します。
    [firecrawl_map] → 47ページ検出
    
    クロールジョブを開始します。
    [firecrawl_crawl] → ジョブID: abc-123
    
    ... ステータス確認中 ...
    
    ✅ 47ページ全て取得完了しました。

ユーザー: 「この3つのURLから商品名と価格を抽出して」

AI: [firecrawl_extract]
    ✅ 構造化データ:
    {"name": "Product A", "price": 2980}
    {"name": "Product B", "price": 4980}
    {"name": "Product C", "price": 7980}

🔒 Sicherheit

• Die gesamte Kommunikation ist durch HTTPS (TLS-Verschlüsselung) geschützt.

• Der Server ist zustandslos. Firecrawl-URL und API-Key werden in den Vercel-Umgebungsvariablen gespeichert und nur während der Anfrage verwendet.

• Der Server enthält keine Datenbank. Er fungiert lediglich als Proxy für die Firecrawl-API.

• Der Quellcode ist vollständig öffentlich.

• Unbefugter Zugriff wird durch MCP_API_KEY verhindert.

FAQ

F: Kann ich auch die Cloud-Version von Firecrawl verwenden? → Ja. Setzen Sie FIRECRAWL_API_URL=https://api.firecrawl.dev und geben Sie Ihren Cloud-API-Key bei FIRECRAWL_API_KEY ein.

F: Das extract-Tool funktioniert nicht. → Bei der selbst gehosteten Version müssen LLM-Einstellungen wie OPENAI_API_KEY auf der Firecrawl-Seite konfiguriert sein. Bitte prüfen Sie den Self-Host Guide.

F: Der Status von Batch-Scrape/Crawl bleibt auf scraping stehen. → Bei der selbst gehosteten Version gibt es eine Verzögerung von einigen Sekunden bei der Statusänderung. Nach 2-3 Abfragen (Polling) sollte der Status auf completed wechseln. Dies ist ein bekanntes Verhalten.

F: Welche Firecrawl-Version wird benötigt? → Eine Version, die die v1 API (/v1/-Endpunkt) unterstützt. Wenn Sie die neueste Version via Docker Compose verwenden, gibt es keine Probleme.

F: Was ist der Unterschied zum HubSpot MA MCP? → Das HubSpot MA MCP dient der Steuerung von HubSpot CRM/MA (128 Tools). Das Firecrawl MCP dient dem Web-Scraping/Crawling (11 Tools). Da die Anwendungsbereiche unterschiedlich sind, können sie zusammen verwendet werden.

Tech-Stack

Next.js 15 / TypeScript / MCP SDK / Vercel / Zod

Lizenz

MIT License

Verwandte MCP-Server

Eine Sammlung von MCP-Servern, die von Hori veröffentlicht wurden. Alle sind über MCP-Clients wie Claude.ai / Cursor / ChatGPT etc. nutzbar.