A Model Context Protocol (MCP) server that provides text generation capabilities using Apple's Foundation Models framework. This server enables MCP clients to access Apple's on-device language models for secure, private text generation.
- Apple Foundation Models Integration: Leverages Apple's on-device language models for text generation
- macOS 26.0 or later (macOS Tahoe)
- Xcode 26.0 or later
- Swift 6.2 or later
- Apple Silicon Mac (for optimal Foundation Models)
-
Clone the repository:
git clone <repository-url> cd mcp-foundation-models
-
Build the project:
swift build -c release
-
The executable will be available at:
.build/release/mcp-foundation-models
Edit Claude configuration file '$HOME/Library/Application Support/Claude/claude_desktop_config.json'
Add this server full path as "mcpServers" sub object
{
"mcpServers": {
"foundation-models": {
"command": "/path/to/mcp-foundation-models/.build/release/mcp-foundation-models",
"args": [
]
}
The server supports configuration through environment variables:
SYSTEM_INSTRUCTIONS
: Set default system instructions for the AI assistantDEBUG
: Enable debug logging (any non-empty value)
- swift-argument-parser: Command line argument parsing
- swift-sdk (MCP): Model Context Protocol implementation
- swift-service-lifecycle: Graceful service lifecycle management
- manage some session id to keep some conversation history
MIT