FoundationModels

What is mcp-foundation-models?

mcp-foundation-models is a Model Context Protocol (MCP) server that provides text generation capabilities by integrating with Apple's on-device Foundation Models framework. It allows MCP clients to securely and privately access Apple's language models for text generation.

How to use mcp-foundation-models?

To use mcp-foundation-models, you first need to build it from source. Clone the repository, navigate into the directory, and run swift build -c release. The executable will be available at .build/release/mcp-foundation-models.

Once built, you can integrate it with MCP clients like Claude Desktop. Edit the Claude configuration file ($HOME/Library/Application Support/Claude/claude_desktop_config.json) and add the server's full path as an mcpServers sub-object. For example:

{
  "mcpServers": {
    "foundation-models": {
      "command": "/path/to/mcp-foundation-models/.build/release/mcp-foundation-models",
      "args": []
    }
  }
}

Environment variables can be used for configuration:

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

Key Features of mcp-foundation-models

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

Use Cases of mcp-foundation-models

• Providing on-device text generation capabilities to MCP clients.
• Integrating Apple's Foundation Models into applications requiring secure and private language model access.

FAQ about mcp-foundation-models

Q: What are the requirements to run mcp-foundation-models? A: You need macOS 26.0 or later (macOS Tahoe), Xcode 26.0 or later, Swift 6.2 or later, and an Apple Silicon Mac for optimal performance with Foundation Models.

Q: Can I set default system instructions for the AI assistant? A: Yes, you can set the SYSTEM_INSTRUCTIONS environment variable to define default system instructions.

Q: How can I enable debug logging? A: Set the DEBUG environment variable to any non-empty value to enable debug logging.

mcp-foundation-models

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.

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 <repository-url>
   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

License

MIT