SpeakSwiftlyMCP

Swift executable package that serves SpeakSwiftly through a streamable MCP HTTP endpoint on macOS.

• Overview
• Setup
• Usage
• Development
• Verification
• MCP Surface
• Configuration
• License

SpeakSwiftlyMCP is the Swift-native sibling to `speak-to-user-mcp`. It keeps the same public MCP tool, prompt, and resource surface while replacing the Python host plus worker subprocess with an in-process SpeakSwiftlyCore runtime.

The current server uses `swift-sdk` for MCP handling and `Hummingbird` for HTTP serving. By default it binds to 127.0.0.1:7341, serves MCP at /mcp, and exposes a simple health endpoint at /healthz.

This package currently expects a sibling SpeakSwiftly checkout at ../SpeakSwiftly because the package graph still uses a local path dependency.

Build the package with:

swift build

If you are iterating on the runtime too, build the adjacent package separately:

cd ../SpeakSwiftly
swift build

Run the local server with:

swift run SpeakSwiftlyMCP

Once it is running, the main MCP endpoint is:

http://127.0.0.1:7341/mcp

The Swift host is intentionally small and direct:

• Main.swift bootstraps logging, the MCP transport, and the Hummingbird application.
• MCPServerFactory.swift registers server metadata plus the mirrored tool, prompt, and resource handlers.
• [SpeakSwiftlyOwner.swift](/Users/galew/Workspace/SpeakSwiftlyMCP/Sources/SpeakSwiftlyMCP/SpeakSwiftlyOwner.swi