local-server について
local-serverはClaude orchestratorをローカルで実行し、Cloudflare tunnel経由で外部のWebhookを受け付けます。ローカルファイルや認証情報、`.env`を使う開発・デバッグ向けの仕組みです。
主な機能
- 01FastAPIサーバーのローカル起動
- 02directive、Webhook一覧、エージェントタスクの各エンドポイント
- 03Cloudflare tunnelによる外部アクセス
- 04ローカルファイル、認証情報、`.env`の利用
- 05ポート設定（デフォルトは8000）
活用シーン
- 01Claude orchestratorのローカルでの反復開発
- 02Webhook関連フローのデバッグ
- 03directiveや汎用エージェントタスクのローカル実行
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/local-serverを入力して読み込まれたか確認します。
詳細
ローカルサーバーの実行
目的
外部からのWebhookアクセスにCloudflare Tunnelを使用して、Claudeオーケストレーターをローカルで実行します。
サーバーの起動
python3 execution/local_server.py
ポート8000でFastAPIサーバーを起動します。
Cloudflare Tunnel
外部からアクセスする場合（Webhookなど）は、Cloudflare Tunnelを使用します。
cloudflared tunnel --url http://localhost:8000
エンドポイント
Modalへのデプロイ時と同じです。
/directive?slug={slug}- ディレクティブを実行します/list-webhooks- Webhookを一覧表示します/general-agent- 一般的なエージェントタスクを実行します
開発での使用
- Modalへのデプロイよりも素早く反復できます
- ローカルのファイルや認証情報にフルアクセスできます
- print文によるリアルタイムデバッグができます
環境
.envファイルを直接使用します（Modalではシークレットを使用します）。
スキーマ
入力
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
port | integer | いいえ | サーバーポート（デフォルト：8000） |
出力
| 名前 | 型 | 説明 |
|---|---|---|
server_url | string | ローカルサーバーのURL（http://localhost:8000） |
tunnel_url | string | Cloudflare TunnelのURL（有効な場合） |
組み合わせて使えるもの
このツールと連携しやすいスキル：add-webhook
費用
無料（ローカルでの実行）
コメント
Markdown 対応