README Documentation
Crawl4AI Model Context Protocol Server
This MCP Server helps you connect to your Crawl4AI docker API server.
Built with gkzhb/fastmcp-template: TypeScript MCP Server Template.
Quick Start
Prerequisites:
- Node.js 18+
To start Crawl4AI MCP server:
export CRAWL4AI_URL=http://your-server-ip:port
npx -y @gkzhb/crawl4ai-mcp
Notice that the command above is for Crawl4AI server v0.6.x.
For Crawl4AI server before v0.6.0, please use 0.0.x:
npx -y @gkzhb/crawl4ai-mcp@0.0.8
This MCP server uses Streamable HTTP. And the default Streamable HTTP URL is http://localhost:8585/mcp.
SSE is also supported and the SSE HTTP URL is http://localhost:8585/sse.
To customize MCP server, here are the shell environment variables:
| Variable | If Optional | Description |
|---|---|---|
CRAWL4AI_URL | Required | Crawl4AI docker API server URL, eg. http://localhost:11545 |
CRAWL4AI_API_TOKEN | Optional | If Crawl4AI server enables authentication, you need to use this |
SERVER_PORT | Optional | MCP server port, default value is 8585 |
This MCP also supports Browserless to crawl web page since v0.2.1
See env.ts for Browserless environment variables:
BROWSERLESS_URLBROWSERLESS_TOKENBROWSERLESS_BLOCK_ADSBROWSERLESS_STEALTH_MODE
Quick Actions
Key Features
Model Context Protocol
Secure Communication
Real-time Updates
Open Source