speak-to-user-mcp

Local FastMCP server that owns one resident SpeakSwiftly worker process and exposes local speech operations over Streamable HTTP on 127.0.0.1:7341/mcp.

This repository is the source-of-truth Python host for SpeakSwiftly.

This service exists to keep the Python MCP host thin while letting SpeakSwiftly stay the source of truth for speech runtime behavior. The MCP side owns one long-lived worker process, exposes local speech operations over Streamable HTTP, and gives Gale a stable machine-local service that Codex can target for spoken replies.

• It caches an Xcode-built SpeakSwiftly runtime directory inside this repo under .local/xcode/.
• If the cache is missing or stale, it rebuilds from ../SpeakSwiftly on startup.
• It keeps one resident worker process alive for the lifetime of the MCP server.
• It loads available profiles on startup and refreshes that in-memory profile snapshot after profile mutations.
• It can run directly with uv or be installed as a macOS LaunchAgent.
• It exposes MCP tools, prompts, and resources from separate server modules so each surface stays easy to reason about.

The worker runtime is intentionally Xcode-backed. SpeakSwiftly now expects the executable to run from the Xcode products directory with its bundled MLX resources available there, so this host caches the products directory shape instead of copying out a naked binary.

SpeakSwiftly remains a separate standalone Swift repository. The larger speak-to-user umbrella repo is expected to consume this repo later as a Git submodule under apps/, while consuming SpeakSwiftly separately under packages/SpeakSwiftly.

Configuration is loaded through pydantic-settings.

• Safe defaults live in `.env`.
• Machine-local overrides belong in .env.local, which is gitignored.
• Environment variables use the SPEAK_TO_USER_MCP_ prefix.

Key defaults: