macOS提醒MCP服务器
Claude Code从…开始macOS的标准提醒应用程序MCP (Model Context Protocol) 服务器。
🚀 机能
- ✅ 获取提醒列表
- ✅ 创建、完成、删除提醒
- ✅ 关键字搜索
- ✅ 期限日设定
- ✅ Claude Code自然语言操作
📋 所需环境
- macOS (AppleScript），模板名称将采用不同的格式
- Node.js 18以降
- 克劳德代码
🛠️ 安装
1.克隆存储库
git clone https://github.com/atani/mcp-server-macos-reminders.git
cd mcp-server-macos-reminders2.安装相关性
npm install3.构建
npm run build4. Claude Code设定
克劳德 Code的配置文件（~/.config/claude/claude_desktop_config.json在工作空间的边缘~/Library/Application Support/Claude/claude_desktop_config.json）中添加以下内容：
{
"mcpServers": {
"reminders": {
"command": "node",
"args": ["/path/to/mcp-server-macos-reminders/dist/index.js"],
"env": {}
}
}
}重要: /path/to/mcp-server-macos-reminders将条目添加到文档注册表。
5. macOS隐私设置
- 系统设置 > 隐私和安全 > 铰刀的双曲正切值
- 终端（或Claude
Code使用的应用程序）授予对提醒的访问权限
🎯 使用方法
基本操作
确认提醒列表
> リマインダーのリスト一覧を表示して创建新提醒
> 「仕事」リストに「会議の準備」というリマインダーを追加して
> 「買うもの」リストに「牛乳を買う」を明日の17時までに追加して完成提醒
> 「仕事」リストの「会議の準備」を完了にして查找提醒
> 「動画」に関するリマインダーを検索して
> 未完了のリマインダーを「仕事」リストから検索して删除提醒
> 「買うもの」リストの「牛乳を買う」を削除して高级用例
成批创建过期提醒
> 来週のプロジェクトタスクを「仕事」リストに追加して：
> - 月曜日: 企画書作成
> - 水曜日: レビューミーティング
> - 金曜日: 最終確認特定期间的提醒确认
> 今日期限のリマインダーをすべて表示して
> 今週中に期限が切れるリマインダーはある？🔧 开発
以开发模式运行
npm run dev测试运行
npm test链接格式
npm run lint
npm run format📚 可用命令
｜命令｜说明｜ | -------------------- | -------------------------------- | | get_reminder_lists 获取所有提醒列表 | get_reminders 获取指定列表的提醒 | create_reminder 创建新的提醒程序 | complete_reminder 将提醒设置为完成状态 | delete_reminder 删除提醒> | search_reminders 用关键字搜索提醒
🔍 故障排除
常见问题
“无法访问提醒应用程序”错误
解决方法:\ macOS终端（或Node.js）中所述修改相应参数的值。
- 系统设置>隐私和安全>提醒
- 打开相应应用程序的复选框
「AppleScript执行错误“
解决方法:
- 确认提醒应用程序已启动
- 确认指定的列表名称是否正确
- 包含特殊字符的列表名用“”括起来指定
Claude Code中未检测到服务器
解决方法:
- 验证配置文件路径是否正确
- Claude Code重新启动
- MCP确保已构建服务器（
npm run build）
调试方法
检查日志
# MCPサーバーを直接実行してログを確認
node dist/index.js
# デバッグモードで実行
DEBUG=mcp:* node dist/index.jsAppleScript手动测试
# リスト一覧の取得テスト
osascript -e 'tell application "Reminders" to get name of every list'
# 特定リストのリマインダー取得テスト
osascript -e 'tell application "Reminders" to get name of every reminder in list "仕事"'🤝 分发
这个项目GitHub Actions进行动态观察时的轴心点。
开发工作流
- 分叉此存储库
- 创建功能分支（
git checkout -b feature/amazing-feature) - 实施更改
- 在本地运行测试
npm run lint # コード品質チェック
npm run build # ビルド検証
npm run test # テスト実行
npm run test:coverage # カバレッジチェック- 提交更改（
git commit -m 'feat: add amazing feature') - 推到分支（
git push origin feature/amazing-feature) - Pull Request创建
CI/CD管道
所有Pull Request将自动执行以下检查：
- 编码质量: ESLint静态分析
- 型安全性: TypeScript类型检查
- 测试：单体测试和集成测试
- 覆盖：80%以上的测试覆盖范围
- 安全性：相关性漏洞检查
- 格式: Prettier代码整形
你必须通过所有这些检查。
分支保护规则
main分支是受保护的，适用以下规则：
- Pull Request需要合并
- 需要一个或多个审核
- 所有状态检查必须通过
- 分支必须是最新的
详细的设置步骤是 来修改标记元素的显示属性。
📄 许可证
这个项目MIT 在许可证下公开。了解更多信息 许可证 请参见文件。
🙏 谢辞
- 模型上下文协议 -
MCP提供框架
- 人类克劳德密码 -提供开发环境
📞 支持
- 🐛 错误报告：
- 💡 机能要望：
- 📖 详细仕样： CLAUDE.md
______________________________________________________________________
注意：此项目包括macOS是专用的。Windows屋脊Linux中所述修改相应参数的值。