AIFace

*AI agent → MCP → your phone renders a live face avatar (emotion in real time).*

Architecture · Emotional Interface · MCP Server · Render Display

AIFace is a 2-part system:

• Render display client (Kotlin Multiplatform) — a passive renderer that runs a WebSocket server at ws://<phone-ip>:8765/ and advertises itself on LAN via mDNS (_ai-face._tcp).
• MCP server (Node.js/TypeScript) — exposes a small tool surface to an LLM (e.g. Claude Desktop), discovers displays via mDNS, then sends Scene DSL updates to the selected display.

The goal: your agent can drive an expressive, real-time face avatar without the mobile app making any “meaning” decisions.

Recommended: open mobile/ in Android Studio and run the androidApp configuration.

Once running on a device, the display endpoint is:

• WebSocket: ws://<phone-ip>:8765/
• mDNS service type: _ai-face._tcp

cd mcp
npm install
npm run build

Add the server to your Claude Desktop config (commonly ~/.claude_desktop_config.json). Use your local paths:

{
  "mcpServers": {
    "ai-face": {
      "command": "node",
      "args": ["/ABS/PATH/TO/AIFace/mcp/dist/index.js"],
      "env": {}
    }
  }
}

Screens (example flow):

![Claude Setu