NOTICE

运行原生 Crawl4AI MCP 服务

此仓库维护了一份固定版本且经过本地验证的 Crawl4AI 0.9.1发行版。它运行上游容器及其原生 Model Context Protocol（MCP）服务，并非自定义 MCP 实现。

启动服务

此本地发行版需要安装 Docker 和 Compose，并提供 API 令牌。为当前 Shell 生成令牌，然后启动固定版本的镜像：

export CRAWL4AI_API_TOKEN="$(openssl rand -hex 32)"
docker compose up -d --wait

服务在 http://127.0.0.1:11235 上侦听。启动前设置 CRAWL4AI_PORT，即可选择其他回环端口。

验证发行版

此冒烟检查会启动隔离的服务栈、检查公共健康状态、验证未经过身份验证的 MCP 访问会失败、验证经过身份验证的架构访问，并移除服务栈。请在常规服务栈停止时运行：

export CRAWL4AI_API_TOKEN="$(openssl rand -hex 32)"
./scripts/smoke.sh

使用以下请求验证常规运行中的服务栈：

base_url="http://127.0.0.1:${CRAWL4AI_PORT:-11235}"
curl --fail --silent --show-error "${base_url}/health"
curl --fail --silent --show-error \
  --header "Authorization: Bearer ${CRAWL4AI_API_TOKEN}" \
  "${base_url}/mcp/schema"

运行静态 Compose 验证，但不启动服务：

./scripts/validate.sh

连接 MCP 客户端

Crawl4AI 提供以下上游原生端点：

• 服务器发送事件（SSE）：http://127.0.0.1:11235/mcp/sse
• WebSocket：ws://127.0.0.1:11235/mcp/ws
• 工具架构：http://127.0.0.1:11235/mcp/schema

除 GET /health 外，每个请求都要发送 Authorization: Bearer ${CRAWL4AI_API_TOKEN}。Crawl4AI 0.9 迁移指南定义了此身份验证约定，上游自托管指南则介绍了 MCP 端点和工具。

Crawl4AI 0.9.1 支持采用 SSE 的旧版 HTTP 和自定义 WebSocket 传输方式。它不提供当前 MCP 传输规范定义的单端点 Streamable HTTP 传输方式。请使用支持旧版 SSE 或 WebSocket 的客户端。

例如，在当前 Shell 中保留令牌，并将本地 SSE 端点添加到 Claude Code：

claude mcp add --transport sse \
  --header "Authorization: Bearer ${CRAWL4AI_API_TOKEN}" \
  crawl4ai http://127.0.0.1:11235/mcp/sse

Claude Desktop 的限制

此仅限回环访问的发行版不提供 Claude Desktop 自定义连接器。Anthropic 的自定义连接器从 Anthropic 云端运行，因此无法访问 127.0.0.1；此仓库也不提供本地 stdio 桥接程序或桌面扩展。请使用 Claude Code，或其他支持经过身份验证的旧版 SSE 的本地客户端。另行评审远程边界的工作已记录在 issue #25。

停止服务

停止并移除常规 Compose 服务栈：

docker compose down

支持的维护范围

此仓库通过固定版本镜像、仅限回环访问的 Compose 默认设置、依赖更新自动化和可执行验证，确保已知上游版本可复现。它不会分叉 Crawl4AI、添加自定义工具，也不再维护已退役的 TypeScript 和 Cloudflare Workers 产品。

可信任的远程身份验证和部署仍推迟处理，详见 issue #25。在实施之前，需要自有的目标环境、凭据策略、TLS 终止，以及针对具体部署的验证。

更新固定版本

每次上游发布新版本时，按以下流程操作：

1. 阅读上游发布说明和 Docker 迁移指南。
2. 更新 compose.yaml 中完整的 unclecode/crawl4ai:<tag>@sha256:<digest> 引用，最好通过 Dependabot 更新。
3. 运行 ./scripts/validate.sh。
4. 导出新的 CRAWL4AI_API_TOKEN，并运行 ./scripts/smoke.sh。
5. 更新此 README 中的版本引用。

在镜像拉取和两项检查都通过之前，不要更改固定版本。

归属与许可证

Crawl4AI、其容器镜像及其 MCP 实现均归上游项目所有。请向上游项目报告运行时或工具行为问题。本仓库仅负责其分发配置和验证。

由本仓库维护的文件采用 MIT 许可证。打包的上游项目仍遵循其 Apache 2.0 许可证及署名条款。