FleetFlow Claude Code Plugin
Claude Code plugin for FleetFlow container orchestration.
環境構築は、対話になった。伝えれば、動く。
Features
- Project Inspection - Analyze FleetFlow projects and view service/stage configurations
- Container Management - Start, stop, restart containers for your project
- Build Support - Build Docker images from Dockerfiles
- Log Viewing - View container logs directly from Claude Code
- Configuration Validation - Validate fleet.kdl syntax and structure
- Cloud Infrastructure - Manage cloud servers (Sakura Cloud) and DNS (Cloudflare)
- Fleet Registry - Manage multiple FleetFlow projects and SSH remote deploy
Installation
# Install FleetFlow CLI (includes MCP server)
cargo install --git https://github.com/chronista-club/fleetflow fleetflow
# Copy plugin config to Claude Code
cp .mcp.json ~/.claude/
MCP Tools
v1: ローカル操作
| Tool | Description | Required Args |
|---|
fleetflow_inspect_project | Analyze fleet.kdl and show project structure | - |
fleetflow_ps | Show container status for project | - |
fleetflow_up | Start containers for a stage | stage |
fleetflow_down | Stop containers for a stage | stage |
fleetflow_deploy | Deploy stage (CI/CD: stop → pull → start) | stage |
fleetflow_logs | View container logs | stage |
fleetflow_restart | Restart a specific service | stage, service |
fleetflow_validate | Validate configuration files | - |
fleetflow_validate_secrets | Validate 1Password secret references | - |
fleetflow_build | Build Docker images | stage |
fleetflow_setup | Setup stage environment (idempotent) | stage |
fleetflow_env | Show environment variables (masked) | stage |
v2: Control Plane 経由
| Tool | Description | Required Args |
|---|
fleetflow_cp_tenant | テナント情報の取得・更新 | - |
fleetflow_cp_project | プロジェクトの CRUD 操作 | slug |
fleetflow_cp_stage | ステージ概要の取得 | project, stage |
fleetflow_cp_service | サービス詳細の取得 | project, stage |
fleetflow_cp_container | コンテナ情報の取得 | project, stage |
fleetflow_cp_server | サーバーの CRUD + 電源操作 | slug |
fleetflow_cp_health | ヘルスチェック状態の取得 | project, stage |
fleetflow_cp_cost | コスト情報の取得 | - |
fleetflow_cp_dns | DNS レコード管理 | project, stage |
Usage Examples
Once installed, you can use FleetFlow tools directly in Claude Code:
User: Show me the FleetFlow project structure
Claude: [Uses fleetflow_inspect_project]
User: Validate the configuration
Claude: [Uses fleetflow_validate]
User: Start the local environment
Claude: [Uses fleetflow_up with stage="local"]
User: Check what's running
Claude: [Uses fleetflow_ps]
User: Show me the logs for the web service
Claude: [Uses fleetflow_logs with stage="local", service="web"]
User: Restart the api service
Claude: [Uses fleetflow_restart with stage="local", service="api"]
User: Build images for local
Claude: [Uses fleetflow_build with stage="local"]
User: Deploy to live
Claude: [Uses fleetflow_deploy with stage="live"]
User: Stop everything
Claude: [Uses fleetflow_down with stage="local", remove=true]
User: Show me the environment variables for local stage
Claude: [Uses fleetflow_env with stage="local"]
User: Validate the 1Password secret references
Claude: [Uses fleetflow_validate_secrets]
ステージ管理
FleetFlowは local / dev / pre / live の4ステージでインフラを統一管理する。MCPツールの stage 引数でステージを指定する。
| ステージ | 用途 |
|---|
local | ローカル開発環境（OrbStack/Docker Desktop） |
dev | 開発サーバー |
pre | ステージング・検証環境 |
live | 本番環境 |
環境変数 FLEET_STAGE を設定すると、MCPツールのデフォルトステージとして使用される。
fleet.kdl 設定の基本
プロジェクトの .fleetflow/fleet.kdl に設定を記述する:
project "myapp"
stage "local" {
service "db"
service "api"
}
service "db" {
image "postgres:16" // image は必須
restart "unless-stopped"
ports {
port host=5432 container=5432
}
env {
POSTGRES_PASSWORD "postgres"
}
}
service "api" {
image "myapp/api:latest"
depends_on "db"
ports {
port host=3000 container=3000
}
}
詳細なKDL構文はスキルの reference/kdl-syntax.md を参照。
Environment Variables
| Variable | Description |
|---|
FLEET_STAGE | Default stage name (local/dev/pre/live) |
FLEETFLOW_CONFIG_PATH | Direct path to config file |
OP_SERVICE_ACCOUNT_TOKEN | 1Password Service Account token (CI/CD) |
CLOUDFLARE_API_TOKEN | Cloudflare API token (for DNS) |
CLOUDFLARE_ZONE_ID | Cloudflare Zone ID |
CLOUDFLARE_DOMAIN | Managed domain |
Requirements
- Docker or OrbStack running
- FleetFlow project with
.fleetflow/fleet.kdl
fleet binary in your PATH- 1Password CLI (
op) v2.x+ for secret management (optional)
Fleet Agent
Fleet Agent はリモートサーバー上で動作する常駐エージェント。Control Plane と双方向通信し、以下を実行する: