mcps-for-macos
mcps-for-macos
一个用于 macOS 自动化的 MCP 服务器(Model Context Protocol)集合。每个服务器通过 AppleScript 或命令行封装一个应用或系统功能,并将其作为工具提供给 AI 应用(Claude Desktop、Claude Code)调用。
服务器 | 包 | 用途 |
Apple 日历 | 读取和创建日程(Calendar.app) | |
Apple 邮件 | 搜索和阅读邮件、保存附件、标记、移动、撰写回复草稿 | |
MoneyMoney | 导出账户和交易记录 | |
Spotlight | 系统级文件搜索(mdfind/mdls) |
公共辅助工具(AppleScript 执行及转义、命令执行)位于 packages/common 中,服务器通过 @mcps/common 使用它们。
什么是 MCP 服务器?
MCP 是一个开放标准,AI 应用(主机)通过它与外部工具和数据通信。服务器提供能力(工具),本身并不了解 AI。通信基于 JSON-RPC 2.0,此处通过 stdio(本地进程)进行。注册意味着:告诉主机如何启动服务器。主机在每次会话启动时将其作为子进程启动,查询其工具并将其提供给 AI。
Related MCP server: macos-mcp-tools
安装
npm install在根目录执行一次 npm install 即可满足所有服务器(npm workspaces)的需求。无需构建步骤:纯 ESM JavaScript,Node >= 18。
注册
每个服务器都需要单独注册,因为每个都是独立的进程。路径必须使用绝对路径;<REPO> 表示此仓库的路径。
Claude Code
# global in allen Projekten (empfohlen für Systemwerkzeuge)
claude mcp add apple-calendar --scope user -- node <REPO>/packages/apple-calendar/src/index.js
claude mcp add apple-mail --scope user -- node <REPO>/packages/apple-mail/src/index.js
claude mcp add money-money --scope user -- node <REPO>/packages/money-money/src/index.js
claude mcp add spotlight --scope user -- node <REPO>/packages/spotlight/src/index.js如果不使用 --scope user,注册仅适用于当前项目。检查和移除:
claude mcp list
claude mcp remove spotlightClaude Desktop
在 ~/Library/Application Support/Claude/claude_desktop_config.json 中:
{
"mcpServers": {
"apple-calendar": { "command": "node", "args": ["<REPO>/packages/apple-calendar/src/index.js"] },
"apple-mail": { "command": "node", "args": ["<REPO>/packages/apple-mail/src/index.js"] },
"money-money": { "command": "node", "args": ["<REPO>/packages/money-money/src/index.js"] },
"spotlight": { "command": "node", "args": ["<REPO>/packages/spotlight/src/index.js"] }
}
}macOS 权限
自动化。 首次访问时,macOS 会请求对 Mail、日历或 MoneyMoney 的自动化访问权限。允许一次即可。
完全磁盘访问。 受保护的位置(例如
~/Library/Mail)只有为执行进程授予完全磁盘访问权限后才能返回结果(系统设置 → 隐私与安全性 → 完全磁盘访问权限)。
本地测试
使用 MCP Inspector 逐个点击测试每个服务器:
npm run inspect -w @mcps/spotlight许可证
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceA read-only MCP server that exposes data from native macOS apps (Mail, Notes, Calendar, Reminders, Contacts, Messages, Spotlight) to AI agents over stdio, currently in early development with no domain tools wired yet.114MIT
- AlicenseNot gradedqualityAmaintenanceA collection of MCP servers for Apple macOS apps (Mail, Contacts, Notes, Memory, Messages, Calendar, Reminders) enabling AI assistants to read, search, create, and update data via JXA, SQLite, and EventKit.12MIT
- AlicenseAqualityBmaintenanceA local MCP server that exposes macOS automation actions (AppleScript + CLIs) as tools, enabling MCP clients on your Mac to control apps, system settings, and more.39MIT
- AlicenseBqualityBmaintenanceAn MCP server that gives AI assistants full access to Apple Mail -- read, search, compose, organize, and analyze emails via natural language.38MIT
Related MCP Connectors
Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.
Let ChatGPT, Claude & Cursor use your Mac: email, calendar, iMessage, Teams, files. Local, free.
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/shaack/mcps-for-macos'
If you have feedback or need assistance with the MCP directory API, please join our Discord server