本地（同一网络）：
  MCP 客户端 ──HTTP──► flipper-mcp.local:8080 (ESP32-S2) ──UART──► Flipper Zero

远程（跨网络）：
  MCP 客户端 ──HTTP──► 中继服务器 ◄──WebSocket── ESP32-S2 ──UART──► Flipper Zero

source ~/export-esp.sh
cd firmware
cargo build --release --target xtensa-esp32s2-espidf
espflash flash --monitor target/xtensa-esp32s2-espidf/release/flipper-mcp

wifi_ssid=YourNetworkName
wifi_password=YourPassword
device_name=flipper-mcp

# 快速健康检查
curl http://flipper-mcp.local:8080/health

# 完整验证——初始化 + 列出所有可用工具
./scripts/test-connection.sh

# 如果你的操作系统无法解析 mDNS，直接传入 IP：
./scripts/test-connection.sh 192.168.x.xxx

curl -X POST http://192.168.0.58:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ble_beacon","arguments":{"data":"020106"}}}'

# 启动 HID 模拟
curl -X POST http://192.168.0.58:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ble_hid_start","arguments":{}}}'

# 输入消息
curl -X POST http://192.168.0.58:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"ble_hid_type","arguments":{"text":"Hello from Flipper!"}}}'

# 停止 HID 模拟
curl -X POST http://192.168.0.58:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"ble_hid_stop","arguments":{}}}'

# NEC 协议 IR 代码（通用电视电源按钮）
curl -X POST http://192.168.0.58:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ir_tx","arguments":{"protocol":"NEC","address":"00","command":"01","repeat":0}}}'

curl -X POST http://192.168.0.58:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"subghz_rx","arguments":{"frequency":433920000,"duration":5000}}}'

{
  "mcpServers": {
    "flipper": {
      "url": "http://flipper-mcp.local:8080/mcp"
    }
  }
}

cd flipper-app && ufbt   # 生成 flipper_mcp.fap
# 将 flipper_mcp.fap 复制到 Flipper SD 卡的 apps/Tools/ 下

./scripts/build-relay.sh
./target/release/flipper-mcp-relay --listen 0.0.0.0:9090
# 然后在 Flipper SD 卡的 config.txt 中添加 relay_url：
# relay_url=ws://your-server:9090/tunnel

# 引导状态存储，然后部署
./infra/bootstrap/aws.sh   # 或 ./infra/bootstrap/gcp.sh
cd infra/aws && cp terraform.tfvars.example terraform.tfvars
tofu init && tofu apply
# 输出中继 URL 和可直接粘贴的 wifi-config.sh 命令

# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh

# 拉取支持工具调用的模型
ollama pull llama3.1        # 8B — 速度与能力良好平衡
# 或：ollama pull qwen2.5   # 强大的工具调用能力，擅长结构化输出
# 或：ollama pull mistral    # 轻量、快速的工具使用

# Docker（推荐）——自动连接到 localhost 上的 Ollama
docker run -d -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
  -e WEBUI_AUTH=False \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

# 或不用 Docker：
pip install open-webui
open-webui serve

flipper-mcp/
├── firmware/          # ESP32-S2 固件（Rust，esp-idf-svc）
├── relay/             # 配套中继服务器（Rust，tokio/axum）
├── flipper-app/       # Flipper Zero FAP——设备内管理 UI（C，ufbt）
├── infra/             # OpenTofu IaC——云中继部署（AWS + GCP）
├── config/            # 示例模块配置
├── scripts/           # 构建、刷写和设置辅助脚本
└── docs/              # 架构、设置、API、故障排除