https://github.com/phimage/mcp-foundation-models
MCP Server to generate message with Apple FoundationModels
https://github.com/phimage/mcp-foundation-models
foundationmodels mcp mcp-server
Last synced: 3 days ago
JSON representation
MCP Server to generate message with Apple FoundationModels
- Host: GitHub
- URL: https://github.com/phimage/mcp-foundation-models
- Owner: phimage
- License: mit
- Created: 2025-06-14T09:31:11.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-06-14T10:22:42.000Z (11 months ago)
- Last Synced: 2025-12-08T23:51:22.988Z (5 months ago)
- Topics: foundationmodels, mcp, mcp-server
- Language: Swift
- Homepage:
- Size: 12.7 KB
- Stars: 5
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **FoundationModels** - An MCP server that integrates Apple's FoundationModels for text generation. `http` `git` `github` (📦 Other)
README
# 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:
```bash
git clone
cd mcp-foundation-models
```
2. Build the project:
```bash
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
```json
{
"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](https://github.com/apple/swift-argument-parser): Command line argument parsing
- [swift-sdk (MCP)](https://github.com/modelcontextprotocol/swift-sdk): Model Context Protocol implementation
- [swift-service-lifecycle](https://github.com/swift-server/swift-service-lifecycle): Graceful service lifecycle management
## TODO
- manage some session id to keep some conversation history
## License
MIT