AI导哈

模型上下文协议服务器

用于苹果设备上基础模型的MCP服务器，支持通过本地Mac免费使用苹果智能服务。

  • by yihan2099
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 yihan2099/apple-fm-mcp

使用说明

苹果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用于设备上的基础模型

安装

来源（推荐）

git clone https://github.com/yihan2099/apple-fm-mcp.git
cd apple-fm-mcp
uv sync

您还需要Apple Foundation Models SDK：

pip install git+https://github.com/apple/python-apple-fm-sdk.git

注： apple-fm-mcp 尚未发布到PyPI。 uv tool install 和 pip install PyPI将在未来的版本中提供。

用法

克劳德代码

claude mcp add apple-fm -- apple-fm-mcp

光标/风帆

添加到MCP配置(~/.cursor/mcp.json 或同等）：

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

MCP检查员

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.主要参考文献：

发展

git clone https://github.com/yihan2099/apple-fm-mcp.git
cd apple-fm-mcp
uv sync --dev
uv run pytest

模拟测试 apple_fm_sdk 所以它们可以在任何平台上运行。

代码检查

uv run ruff check src/ tests/
uv run ruff format src/ tests/

贡献

看 贡献.md 作为指导方针。

许可证

麻省理工学院

相关 MCP