Metadata-Version: 2.4
Name: apple-fm-mcp
Version: 1.0.1
Summary: MCP server exposing Apple Foundation Models to Claude Code and Claude Desktop
Project-URL: Homepage, https://likeone.ai
Project-URL: Repository, https://github.com/sophiacave/apple-fm-mcp
Project-URL: Documentation, https://likeone.ai/blog/apple-foundation-models-swift-developer-guide-2026/
Author-email: Sophie Cave <hello@likeone.ai>
License-Expression: MIT
Keywords: ai,apple,claude,foundation-models,llm,mcp,on-device
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: apple-fm-sdk>=0.2.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

<!-- mcp-name: io.github.sophiacave/apple-fm-mcp -->
# Apple Foundation Models MCP Server

Expose Apple's on-device 3B parameter LLM to Claude Code and Claude Desktop via MCP. Zero API cost, fully private, runs on Neural Engine.

## Requirements

- macOS 26+ (Tahoe or later)
- Apple Silicon (M1/M2/M3/M4)
- Apple Intelligence enabled in System Settings
- Python 3.10+

## Install

```bash
pip install apple-fm-mcp
```

## Configure

Add to your Claude Code config (`~/.claude/mcp.json`):

```json
{
  "mcpServers": {
    "apple-fm": {
      "command": "apple-fm-mcp"
    }
  }
}
```

Or Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "apple-fm": {
      "command": "apple-fm-mcp"
    }
  }
}
```

## Tools

| Tool | Description | Latency |
|------|-------------|---------|
| `fm_generate` | Free-form text generation | ~1s |
| `fm_summarize` | Summarize text into bullet points | ~4s |
| `fm_classify` | Classify text into categories | ~2s |
| `fm_extract` | Extract structured data from text | ~3s |
| `fm_status` | Check model availability | instant |

## Why Use This?

- **Free**: No API keys, no tokens, no cloud costs
- **Private**: All inference on-device, no data leaves your Mac
- **Fast**: Neural Engine optimized, ~1s for generation
- **Complementary**: Use alongside Claude for tasks where on-device speed matters

## When to Use Apple FM vs Claude

| Task | Use Apple FM | Use Claude |
|------|-------------|-----------|
| Quick classification | Yes | Overkill |
| Text summarization | Yes (short text) | Yes (long documents) |
| Code generation | No | Yes |
| Complex reasoning | No | Yes |
| Data extraction | Yes (simple) | Yes (complex) |
| Privacy-critical | Yes | Depends |

## Built by [Like One](https://likeone.ai)

AI education from a 501(c)(3) nonprofit. 50+ free courses on Claude, MCP, agents, and AI architecture.

## License

MIT
