Apple MCP Server

🚀 Apple MCP 工具

这是一个专为苹果设备打造的工具集合，基于 MCP 协议 开发，能为苹果设备用户提供丰富的功能支持。

以下是关于如何设置和演示的分步视频：查看视频

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

🚀 快速开始

快速安装

通过 Smithery 可自动为 Claude Desktop 安装 Apple MCP：

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

若要为 Cursor 安装，可使用以下命令：

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

✨ 主要特性

• 消息：
  • 可使用 Apple Messages 应用发送消息。
  • 支持播报消息内容。
• 笔记：
  • 能列出所有笔记。
  • 可在 Apple Notes 应用中搜索和阅读笔记。
• 联系人：
  • 可搜索联系人以获取发送消息的信息。
• 邮件：
  • 支持发送带有多个收件人（包括抄送和密送）的电子邮件。
  • 可使用自定义查询、邮箱选择和结果限制来搜索邮件。
  • 能安排未来时间送达的邮件。
  • 可列出并管理已安排的邮件。
  • 能检查全局或按邮箱的未读邮件数量。
• 提醒事项：
  • 可列出所有提醒事项及提醒列表。
  • 能根据文本搜索提醒事项。
  • 可创建新的提醒事项，可选设置截止日期和备注。
  • 可在 Reminders 应用中打开以查看特定提醒事项。
• 日历：
  • 可使用自定义日期范围搜索日历事件。
  • 能列出即将进行的活动。
  • 可创建新日历事件，包含标题、地点和备注等详细信息。
  • 可在 Calendar 应用中打开特定的日历事件。
• 网络搜索：
  • 可在 Google 等平台执行网页搜索。
  • 能获取搜索结果列表。
  • 可打开指定的搜索结果链接。
• 地图：
  • 可搜索地理位置并获取经纬度坐标。
  • 能查看位置信息。

📦 安装指南

快速安装

通过以下命令可在 macOS 或 Linux 上快速安装工具：

sudo apt-get update && sudo apt-get install -y curl unzip
curl -L "https://github.com/yourusername/apple-mcp/raw/main/install.sh" | bash

手动安装

1. 安装 Node.js 和 npm：

# 使用 nvm 安装 Node.js 14.x 或更高版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
source ~/.bashrc
nvm install --lts

2. 克隆仓库并安装依赖：

git clone https://github.com/yourusername/apple-mcp.git
cd apple-mcp
npm install

3. 启动服务：

node index.js

💻 使用示例

基础用法

发送邮件

{
  "command": "send_email",
  "args": {
    "to": "recipient@example.com",
    "subject": "Test Email",
    "body": "This is a test email from the MCP tool."
  }
}

搜索地理位置

{
  "command": "search_location",
  "args": {
    "query": "New York City"
  }
}

高级用法

获取天气信息

{ command: 'get_weather', args: { location: 'London' } }

搜索附近餐馆

{ command: 'search_restaurants', args: { location: 'Tokyo' } }

本地开发

1. 克隆仓库并安装依赖：

git clone https://github.com/yourusername/apple-mcp.git
cd apple-mcp
npm install

2. 启动开发服务器：

npm run dev

3. 测试功能：

• 访问 http://localhost:3000 查看文档和测试界面。
• 使用提供的 API 接口进行功能测试。

更多详细信息请参考项目文档或仓库中的 README 文件。

📚 详细文档

参考资料

• MCP 协议官方文档
• Smithery 平台
• Node.js 官方网站
• NPM 官方仓库