NOTICE

ネイティブ Crawl4AI MCP サーバーを実行する

このリポジトリは、Crawl4AI 0.9.1 の固定され、ローカルで検証済みのディストリビューションを維持しています。これはアップストリームのコンテナとそのネイティブな Model Context Protocol (MCP) サーバーを実行します。カスタムの MCP 実装ではありません。

サービスを起動する

ローカルディストリビューションには、Compose を備えた Docker と API トークンが必要です。現在のシェル用のトークンを生成し、固定されたイメージを起動します。

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 は、これらのアップストリームネイティブのエンドポイントを公開しています。

• Server-Sent Events (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 をサポートするクライアントを使用してください。

たとえば、トークンを現在のシェルに保持したまま、ローカルの 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 License を使用します。パッケージ化された上流プロジェクトは、その Apache 2.0 ライセンスおよび帰属条項 を保持します。