mcp-foundation-models

A Model Context Protocol (MCP) server that provides text generation capabilities using Apple's Foundation Models framework.

Features

• Apple Foundation Models Integration: Leverages Apple's on-device language models for text generation

Requirements

• macOS 26.0 or later (macOS Tahoe)
• Xcode 26.0 or later
• Swift 6.2 or later
• Apple Silicon Mac (for optimal Foundation Models)

Installation# Building from Source

1. Clone the repository:

   git clone https://github.com/phimage/mcp-foundation-models
   cd mcp-foundation-models
   

2. Build the project:

   swift build -c release
   

3. The executable will be available at:

   .build/release/mcp-foundation-models
   

Use it in Claude Desktop for instance

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": [ ]
    }
  }
}

Environment Variables

The server supports configuration through environment variables:

• SYSTEM_INSTRUCTIONS: Set default system instructions for the AI assistant
• DEBUG: Enable debug logging (any non-empty value)

Dependencies

• swift-argument-parser: Command line argument parsing
• swift-sdk (MCP): Model Context Protocol implementation
• swift-service-lifecycle: Graceful service lifecycle management

TODO

• manage some session id to keep some conversation history