Macos App MCP

macOS MCP服务器

用于深度macOS集成的生产就绪模型上下文协议（MCP）服务器： 笔记、提醒、日历、联系人和消息。

✨ 特性

• 🗒️ 备注 -支持分层文件夹的完整CRUD
• ✅ 提醒事项 -跨多个列表管理任务
• 📅 日历 -查看、创建和管理事件
• 👥 联系人 -深度搜索和详细信息检索
• 💬 沟通 -发送iMessage并发起电话
• 🛡️ 恢复 -高保真“最近删除”恢复程序和版本回滚
• 🔒 安全 -用于破坏性操作的安全锁和基于ID的确认

🚀 快速开始

1.配置您的MCP客户端

将此添加到MCP配置中：

{
  "mcpServers": {
    "macos": {
      "command": "npx",
      "args": ["-y", "macos-app-mcp"],
      "env": {
        "MCP_NOTES_FOLDER": "ai",
        "MCP_REMINDERS_LIST": "ai",
        "MCP_ALLOW_DELETE": "false"
      }
    }
  }
}

2.开始使用

配置后，您可以询问您的AI助手：

• What's on my calendar today?
• Create a note titled 'Meeting Notes' with today's action items
• Add a reminder to call John tomorrow at 10am
• Find contact info for Alice

🛠️ 可用工具（共29个）

⚙️ 配置

🔧 发展

设置

git clone https://github.com/zenheart/macos-app-mcp
cd macos-app-mcp
pnpm install
pnpm build

测试

# Run unit tests (mocked, safe to run)
pnpm test

# Run unit tests in watch mode
pnpm test:watch

# Run with coverage report
pnpm test:coverage

集成测试

⚠️ 警告：集成测试与 真正的macOS应用程序 （备注、提醒、日历）。测试项目前缀为 MCP-TEST- 用于识别。

# Run integration tests against real macOS apps
pnpm test:integration

已知限制：

• 备注：由于iCloud同步延迟，新创建的笔记可能无法通过AppleScript立即找到
• 联系人：联系人应用程序必须运行才能通过与联系人相关的测试
• 由于这些macOS应用程序的限制，跳过了一些测试

MCP检查员游乐场

MCP检查器为手动测试工具提供了一个交互式web UI：

# Build and start MCP Inspector (opens http://localhost:5173)
pnpm playground:dev

# Or if already built
pnpm playground

检查员允许您：

• 浏览所有可用工具
• 使用自定义参数执行工具
• 查看响应和调试问题
• 监控服务器日志

开发流程

1. 在中更改源文件 src/
2. 跑 pnpm dev 用于监视模式（保存时自动重建）
3. 使用单元测试进行测试： pnpm test
4. 交互式测试： pnpm playground:dev
5. 在提交PR之前运行集成测试： pnpm test:integration

类型检查

pnpm lint

发布工作流

该项目使用GitHub Actions的自动版本碰撞：

# Patch release (1.0.2 -> 1.0.3) - for bug fixes
pnpm release

# Minor release (1.0.2 -> 1.1.0) - for new features
pnpm release:minor

# Major release (1.0.2 -> 2.0.0) - for breaking changes
pnpm release:major

这将：

1. 运行棉绒和测试
2. 构建项目
3. 将版本插入 package.json
4. 创建一个git标签（例如。， v1.0.3)
5. 推送到GitHub→ 触发自动NPM发布

📄 许可证

MIT© 曾哈特