AI导哈

MCP服务器部署工具

用于本地部署和验证Crawl4AI模型上下文协议（MCP）服务器的工具，支持Docker容器化运行和客户端连接验证。

  • by BjornMelin
  • Shell
  • 本地部署
  • 30 星标
  • 更新于
在 GitHub 查看 BjornMelin/crawl4ai-mcp-server

使用说明

运行本机Crawl4AI MCP服务器

此存储库维护了一个固定的、经过本地验证的分发 Crawl4AI 0.9.1它运行上游容器及其本地模型上下文协议（MCP）服务器。它不是自定义MCP实现。

启动服务

本地分发需要使用Compose的Docker和API令牌。为当前shell生成一个令牌，然后启动固定映像：

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

服务正在监听 http://127.0.0.1:11235.Set 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
  • 双向通信: ws://127.0.0.1:11235/mcp/ws
  • 工具架构: http://127.0.0.1:11235/mcp/schema

发送 Authorization: Bearer ${CRAWL4AI_API_TOKEN} 除了 GET /healthThe Crawl4AI 0.9迁移指南 定义此身份验证契约，以及 上游自助托管指南 记录MCP端点和工具。

Crawl4AI 0.9.1支持带有SSE和自定义WebSocket传输的传统HTTP。它不公开由 当前MCP传输规范。使用具有传统SSE或WebSocket支持的客户端。

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

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

Claude桌面限制

此仅环回分发不提供Claude Desktop自定义连接器。Anthropic 的 自定义连接器从Anthropic的云端运行，所以他们无法到达 127.0.0.1；此存储库也不附带本地stdio桥或桌面扩展。使用Claude Code或支持经过身份验证的旧式SSE的其他本地客户端。在中跟踪单独审查的远程边界 问题#25.

停止服务

停止并删除常规Compose堆栈：

docker compose down

支持的维护范围

此存储库通过固定映像、仅环回的Compose默认值、依赖关系更新自动化和可执行文件验证来保持已知上游版本的可重复性。它不会分叉Crawl4AI，添加自定义工具，也不会维护退役的TypeScript和Cloudflare Workers产品。

受信任的远程身份验证和部署仍然推迟到 问题#25。在实施之前，它们需要一个自有的目标环境、凭据策略、TLS终止和特定于部署的验证。

更新固定版本

对每个上游释放使用此程序：

  1. 阅读 上游发行说明 Docker迁移指南。
  2. 更新完整 unclecode/crawl4ai:<tag>@sha256:<digest> 参考 compose.yaml，最好通过Dependabot。
  3. 跑 ./scripts/validate.sh.
  4. 出口新鲜 CRAWL4AI_API_TOKEN 然后跑 ./scripts/smoke.sh.
  5. 更新此README中的版本参考。

在图像拉动且两个检查都通过之前，不要移动销钉。

所有权和许可

Crawl4AI，其容器映像及其MCP实现属于上游项目。在那里报告上游运行时或工具行为。此存储库仅拥有其分发配置和验证。

存储库维护的文件使用 MIT 许可证打包的上游项目保留了其 Apache 2.0许可和归属条款.

相关 MCP