苹果fm mcp
适用于Apple的MCP服务器,适用于Foundation型号的设备。从Mac上本地免费运行的任何MCP客户端(Claude Code、Cursor、Windsurf)使用Apple Intelligence。
建立在 python-apple-fm-sdk 和那个 模型上下文协议.
需求
- 启用了Apple Intelligence的macOS 26+(Tahoe)
- 苹果硅Mac(M1+)
- Python 3.10+
apple-fm-sdk--Apple的Python SDK用于设备上的基础模型
安装
来源(推荐)```bash
git clone https://github.com/yihan2099/apple-fm-mcp.git
cd apple-fm-mcp
uv sync
您还需要Apple Foundation Models SDK:```bash
pip install git+https://github.com/apple/python-apple-fm-sdk.git
> 注:
apple-fm-mcp 尚未发布到PyPI。 uv tool install 和 pip install PyPI将在未来的版本中提供。
用法
克劳德代码```bash
claude mcp add apple-fm -- apple-fm-mcp
### 光标/风帆
添加到MCP配置(`~/.cursor/mcp.json` 或同等):```json
{
"mcpServers": {
"apple-fm": {
"command": "apple-fm-mcp"
}
}
}
MCP检查员```bash
npx @modelcontextprotocol/inspector apple-fm-mcp
## 工具
|工具|说明|
|------|-------------|
| `check_model_availability` |检查设备上的型号是否可用|
| `generate` |带有可选指令的一次性文本生成|
| `generate_structured` |JSON输出与提供的模式匹配|
| `chat` |具有命名会话的多回合对话|
| `tag_content` |使用Apple的Content_TAGING用例进行内容标记|
| `list_sessions` |列出活动对话会话|
| `clear_session` |删除命名会话|
| `clear_all_sessions` |删除所有会话|
### 例子
**生成文本:**
> “使用apple fm解释Swift中的闭包是什么”
**结构化输出:**
> “使用apple fm generate_structured从以下文本中提取{姓名、电子邮件、公司}:…”
**多回合聊天:**
> “启动一个名为“代码审查”的apple fm聊天会话,并要求它审查此功能”
> “在‘代码审查’环节中,请它提出改进建议”
## 资源
|URI|描述|
|-----|-------------|
| `apple-fm://status` |型号可用性+设备信息|
| `apple-fm://sessions` |活动会话元数据|
| `apple-fm://transcript/{name}` |会话会话记录|
## 提示模板
|提示|参数|说明|
|--------|-----------|-------------|
| `summarize` | `text`, `style` (简明/详细/要点)|总结文本|
| `extract_structured` | `text`, `fields` (逗号分隔)|将命名字段提取为JSON|
| `classify` | `text`, `categories` (逗号分隔)|单标签分类|
## 局限性
- **仅限macOS** --Apple Foundation型号需要Apple Silicon和macOS 26+
- **无流媒体** --MCP工具返回完整的响应
- **内存会话** --服务器重新启动时,对话状态丢失
- **设备型号限制** --该模型针对短任务(摘要、提取、分类)而不是长表单生成进行了优化
- **无图像/音频** --仅文本;多模式支持可能会出现在未来的SDK版本中
## SDK文档
此项目已完成 `apple-fm-sdk`.主要参考文献:
- 官方SDK文档 -入门,指南,API完整参考
- 当地API参考 --此MCP服务器使用的类和枚举的精选摘要
## 发展```bash
git clone https://github.com/yihan2099/apple-fm-mcp.git
cd apple-fm-mcp
uv sync --dev
uv run pytest
模拟测试 apple_fm_sdk 所以它们可以在任何平台上运行。
代码检查```bash
uv run ruff check src/ tests/
uv run ruff format src/ tests/
```
贡献
看 贡献.md 作为指导方针。
许可证
麻省理工学院
