Crawl4ai Local for Windows

Windows에서 사용하는 Crawl4ai 로컬 MCP 서버입니다. WSL을 설치할 필요 없이 바로 실행할 수 있습니다.

참고 자료: - https://github.com/unclecode/crawl4ai - https://docs.crawl4ai.com/

요구 사항

이 프로젝트를 실행하려면 uv와 Python 3.14가 필요합니다.

Related MCP server: crawl4ai-mcp-server

설치

uv sync

실행

🚨️ MCP를 코딩 에이전트에 올바르게 연결하면 에이전트가 서버를 자동으로 시작하므로 별도로 실행할 필요가 없습니다.

uv run main

터미널에서 디버깅 모드(MCP Inspector)로 실행하려면:

uv run mcp dev src/crawl4ai_local_for_windows/server.py

에이전트에 MCP 추가

Claude Code

claude mcp add --transport stdio --scope user crawl4ai -- uv run --directory <parent_location>\crawl4ai-local-for-windows main

parent_location: C:\dev\repo\fix-a-lot처럼 작성하세요.

• 예: claude mcp add --transport stdio --scope user crawl4ai -- uv run --directory C:\dev\repo\fix-a-lot\crawl4ai-local-for-windows main

# Check MCP installation
claude mcp list
claude mcp get crawl4ai

Hermes Agent

{
  "mcpServers": {
    "crawl4ai": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "<parent_location>\\crawl4ai-local-for-windows",
        "main"
      ]
    }
  }
}

parent_location: C:\\dev\\repo\\fix-a-lot처럼 작성하세요.

• 예: C:\\dev\\repo\\fix-a-lot\\crawl4ai-local-for-windows

🚧 프로젝트 스캐폴딩에 사용한 명령어

uv init
uv add crawl4ai mcp
uv run crawl4ai-setup