server/readme.md

Folyo Server

The Folyo server lets AI agents control devices or VMs over WebSockets. Devices connect to the server, identify themselves with a device ID, and stay online as execution targets. An AI client can then call the server and ask it to list connected devices or execute shell commands on a specific device. The server acts as the bridge between agent-facing APIs and device-side WebSocket sessions.

Building

Build the binary:

cargo build --release

Build the image:

docker build -t server .

Endpoints

• GET /connect for device WebSocket connections
  • requires Authorization: Bearer <token>
  • requires X-Device-ID: <device-id>
• POST /mcp for MCP/JSON-RPC requests
  • typically uses Authorization: Bearer <token>
• GET /mcp for MCP server-sent events
  • provides a minimal SSE stream for MCP clients that probe or require it