Apple Tools Integration - MCP 服务器

项目简介

Apple Tools Integration 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在将苹果设备的原生应用功能（如信息、备忘录、通讯录、邮件和提醒事项）以及网页搜索能力桥接到大型语言模型 (LLM) 客户端。通过此 MCP 服务器，LLM 应用可以安全、可扩展地访问和利用这些本地资源，从而实现更丰富和个性化的用户交互体验。

主要功能点

信息 (Messages):
- 发送 iMessage 信息
- 读取信息内容
备忘录 (Notes):
- 列出备忘录
- 搜索和读取备忘录内容
通讯录 (Contacts):
- 搜索联系人信息
邮件 (Emails):
- 发送邮件（支持抄送、密送和附件）
- 搜索邮件
- 列出和管理定时发送邮件
- 查询未读邮件数量
提醒事项 (Reminders):
- 列出所有提醒事项和列表
- 按文本搜索提醒事项
- 创建新的提醒事项
- 打开提醒事项应用查看指定事项
网页搜索 (Web Search):
- 使用 DuckDuckGo 进行网页搜索并获取搜索结果内容

安装步骤

安装 Bun: 确保您的 macOS 系统已安装 Bun JavaScript 运行时。如果未安装，请打开终端并运行命令：
```
brew install oven-sh/bun/bun
```

配置 MCP 服务器: 您可以通过 Smithery CLI 自动安装 Apple MCP，或者手动配置。

自动安装 (推荐): 如果您使用 Claude Desktop 或 Cursor 等 MCP 客户端，可以通过 Smithery CLI 快速安装 Apple MCP。

Claude Desktop:

npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client claude

Cursor:

npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client cursor

手动安装: 如果您需要手动配置，请按照以下步骤操作：

克隆 GitHub 仓库到本地：

git clone https://github.com/dhravya/apple-mcp.git
cd apple-mcp

安装项目依赖：
```
bun install
```

服务器配置

对于 MCP 客户端（如 Claude Desktop），您需要在其配置文件中添加 Apple MCP 服务器的配置信息。以下是配置示例（JSON 格式），通常您需要将此配置添加到客户端的 'mcpServers' 字段中。

{
  "mcpServers": {
    "apple-mcp": {
      "command": "bunx",
      "args": ["@dhravya/apple-mcp@latest"]
    }
  }
}

配置参数说明:

'"apple-mcp"': 服务器名称，您可以自定义，用于在客户端中引用此服务器。
'"command": "bunx"': 启动服务器的命令，'bunx' 用于执行 npm 包，这里表示执行全局安装的 '@dhravya/apple-mcp' 包。
'"args": ["@dhravya/apple-mcp@latest"]': 传递给 'bunx' 命令的参数，'"@dhravya/apple-mcp@latest"' 指定要执行的 npm 包及其版本。

基本使用方法

配置完成后，在您的 MCP 客户端中，您可以指示 LLM 使用 'apple-mcp' 工具来执行相应的苹果原生应用功能。例如，在 Claude 中，您可以这样提问：

'Can you send a message to John Doe?' (你能给 John Doe 发送一条信息吗？)
'find all the notes related to AI and send it to my girlfriend' (找到所有关于 AI 的备忘录，并发送给我的女朋友)
'create a reminder to "Buy groceries" for tomorrow at 5pm' (创建一个提醒事项 “Buy groceries”，时间为明天下午 5 点)

LLM 将会调用 'apple-mcp' 服务器提供的工具来完成您的请求。

本地开发: 如果您需要进行本地开发或调试，可以运行以下命令启动服务器：

cd apple-mcp
bun run index.ts

关键词