🚀 Apple MCP 工具
这是一个专为苹果设备打造的工具集合，基于 MCP 协议 开发，能为苹果设备用户提供丰富的功能支持。
以下是关于如何设置和演示的分步视频：查看视频
以下是复制的 JSON 代码
{
"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
手动安装
- 安装 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
- 克隆仓库并安装依赖：
git clone https://github.com/yourusername/apple-mcp.git
cd apple-mcp
npm install
- 启动服务：
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' } }
本地开发
- 克隆仓库并安装依赖：
git clone https://github.com/yourusername/apple-mcp.git
cd apple-mcp
npm install
- 启动开发服务器：
npm run dev
- 测试功能：
- 访问
http://localhost:3000查看文档和测试界面。 - 使用提供的 API 接口进行功能测试。
更多详细信息请参考项目文档或仓库中的 README 文件。