Mac MCP (Barelyworkingcode)

macMCP

独立的Swift MCP服务器通过stdio公开macOS原生工具。11个服务中的42个工具。没有外部依赖关系。

工具

日历

联系人

提醒事项

位置

地图

捕捉

邮件

消息

捷径

公用事业

天气

需求

• macOS 13+
• Swift 5.9+
• 无外部依赖（仅系统框架）

权限

根据需要在“系统设置”>“隐私和安全”中授予这些权限：

• 联系人 --联系人访问
• 日历 --日历访问
• 提醒事项 --提醒访问
• 位置 --位置服务（首次使用时，macOS将提示允许；单击 允许)
• 消息 --全磁盘访问（读取 chat.db 直接）
• 邮件 --Mail.app的自动化权限（使用JXA）

构建和安装

swift build              # debug
./build.sh               # release, codesigned, installs to ~/.local/bin, registers with Relay

build.sh 将二进制文件安装到 ~/.local/bin/macmcp 并将其注册到Relay（如果已安装）。

配置

带继电器（推荐）

build.sh 自动处理注册。要手动注册，请执行以下操作：

relay mcp register --name macMCP --command ~/.local/bin/macmcp

独立

添加到MCP客户端配置中（例如。 claude_desktop_config.json):

{
  "mcpServers": {
    "macmcp": {
      "command": "~/.local/bin/macmcp"
    }
  }
}

相关项目

macMCP是三个项目的一部分，这些项目相结合，为LLM提供了对macOS的安全访问。每个都独立工作，但它们一起形成了一个完整的堆栈： 夏娃 提供LLM聊天界面， 中继 处理编排和安全性，以及 macMCP 暴露了macOS的原生功能。向Relay注册macMCP，任何MCP客户端（包括Eve）都可以访问其42个工具——由每个令牌的权限限定，因此不同的项目可以有不同的访问级别。

• 中继 --适用于macOS的MCP编排器。macMCP通过Relay自动注册 relay mcp register，Relay通过具有每个工具权限的单个令牌身份验证连接代理其工具。
• fsMCP --跨平台文件系统MCP服务器（读、写、编辑、glob、grep、bash）。通过文件操作功能补充macMCP的macOS原生工具。
• 夏娃 --具有项目、文件编辑和终端的多提供商LLM web界面。当Eve和macMCP都向Relay注册时，LLM会话可以访问macOS本机工具。

致谢

特别感谢 mattt/iMCP 为了灵感。