🔥 Firecrawl MCP 서버

자체 호스팅 Firecrawl을 Claude에서 MCP로 조작합니다.

LP: daisukehori.github.io/firecrawl-mcp

자체 호스팅된 Firecrawl을 MCP(Model Context Protocol)를 통해 Claude.ai / Claude Desktop / Claude Code에서 직접 조작할 수 있습니다.

웹 검색, 단일/배치 스크래핑, 사이트 크롤링, 사이트맵 가져오기, LLM 구조화 추출 등 11가지 도구를 탑재했습니다.

아키텍처

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

Vercel의 Next.js 앱이 MCP 프로토콜을 처리하고 자체 호스팅 Firecrawl API로 중계합니다. 서버는 상태 비저장(stateless) 방식이며, 데이터 저장이나 로그 출력은 수행하지 않습니다.

Related MCP server: Firecrawl MCP Server

도구 목록 (11개)

스크래핑

크롤링

검색·매핑·추출

퀵스타트 (3단계)

1단계: 자체 호스팅 Firecrawl 준비

Firecrawl 자체 호스팅 가이드에 따라 Firecrawl을 실행합니다.

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

기본적으로 http://localhost:3002에서 실행됩니다.

2단계: MCP 서버 배포

원클릭 배포 (권장)

수동 배포

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

3단계: Claude에서 연결

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

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

• Header 이름: x-api-key 값: 당신의 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"

환경 변수

사용 예시

ユーザー: 「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}

🔒 보안

• 모든 통신은 **HTTPS(TLS 암호화)**로 보호됩니다.

• 서버는 **상태 비저장(stateless)**입니다. Firecrawl URL과 API 키는 Vercel 환경 변수에 저장되며 요청 중에만 사용됩니다.

• 서버에 데이터베이스가 없습니다. Firecrawl API에 대한 프록시로만 작동합니다.

• 소스 코드는 모두 공개되어 있습니다.

• MCP_API_KEY를 통해 무단 액세스를 방지합니다.

FAQ

Q: Firecrawl 클라우드 버전에서도 사용할 수 있나요? → 네. FIRECRAWL_API_URL=https://api.firecrawl.dev로 설정하고 FIRECRAWL_API_KEY에 클라우드 API 키를 입력하세요.

Q: extract 도구가 작동하지 않습니다. → 자체 호스팅 버전에서는 Firecrawl 측에 OPENAI_API_KEY 등의 LLM 설정이 필요합니다. 자체 호스팅 가이드를 확인하세요.

Q: 배치 스크래핑/크롤링 상태가 scraping에서 멈춰 있습니다. → 자체 호스팅 버전에서는 상태 전환에 몇 초의 지연이 있습니다. 2~3회 폴링하면 completed가 됩니다. 이는 알려진 동작입니다.

Q: Firecrawl 어떤 버전이 필요한가요? → v1 API(/v1/ 엔드포인트) 지원 버전. Docker Compose에서 최신 버전을 사용하면 문제없습니다.

Q: HubSpot MA MCP와 무엇이 다른가요? → HubSpot MA MCP는 HubSpot CRM/MA 조작용(128개 도구)입니다. Firecrawl MCP는 웹 스크래핑/크롤링용(11개 도구)입니다. 용도가 다르므로 함께 사용할 수 있습니다.

기술 스택

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

라이선스

MIT License

관련 MCP 서버

Hori가 공개한 MCP 서버 모음입니다. 모두 Claude.ai / Cursor / ChatGPT 등의 MCP 클라이언트에서 사용할 수 있습니다.