麦克塞

Name: 麦克塞
Author: macuse-app

作者：macuse-app4 星标更新：2025-09-18

安装使用来源：spider==github.com

项目介绍

【技术文档摘要】：

Macuse

<p align="center"> <img src="https://gips0.baidu.com/it/u=2148891778,1195404390&fm=3081&app=3081&f=PNG?w=2048&h=2048" alt="Macuse" width="128" height="128"> </p> <h3 align="center"> 在macOS上赋予AI超级能力 </h3> <p align="center"> 将AI与任何macOS应用程序连接起来。深度集成原生应用如日历、邮件、笔记，并控制所有应用的用户界面。支持Claude、Cursor、Raycast以及任何兼容MCP的AI。 </p> <p align="center"> <a href="#"><img src="https://img.shields.io/badge/platform-macOS_10.15+-lightgreen" alt="平台"></a> <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-Compatible-green" alt="MCP兼容"></a> <a href="#releases"><img src="https://img.shields.io/badge/CI-GitHub%20Releases-blue" alt="发布"></a> </p> <p align="center"> <a href="https://macuse.app/download/">下载</a> • <a href="#releases">发布</a> • <a href="https://macuse.app">网站</a> </p>

Macuse是一款双模式桌面应用，通过模型上下文协议（MCP）将AI助手与macOS原生功能连接起来。它使AI客户端能够控制Mac应用程序，访问系统信息并自动化工作流程，同时保证安全性和用户隐私。

主要特性

Macuse通过工具箱提供实用的本地功能，包括：

系统：启动和管理应用程序，执行通用系统操作
检查器：探索应用程序UI结构以理解元素
交互：点击/输入/与UI元素互动
日历及提醒事项：读取和管理事件及提醒事项（需同意）
联系人、笔记、消息：访问常见的个人应用（需同意）
位置及地图：读取当前位置并使用地图功能（需同意）

一切都在本地运行。访问受您控制的令牌保护，敏感操作需要相应的macOS权限。

安装

从网站下载最新安装程序：https://macuse.app/download/
解压下载的文件。
将Macuse.app拖放到您的应用程序文件夹中。

配置Macuse

打开Macuse以查看和调整您的连接和功能：

访问令牌：复制您的令牌以连接客户端，您可以随时重新生成。
传输模式：
- 标准输入输出（Stdio）：直接连接无需开放端口，适用于大多数客户端。
- 服务器发送事件（SSE）：在绑定地址/端口上运行本地服务器并流式传输事件。
- 可流式传输HTTP：运行适合偏好HTTP的客户端的本地HTTP端点。
网络（针对SSE/HTTP）：
- 绑定地址：默认127.0.0.1（仅限本地）。
- 端口：默认35729。使用内置端口检查以避免冲突。
工具箱：启用/禁用诸如检查器、交互、日历、联系人、消息、笔记和位置等功能。
权限：当需要时，macOS会提示您授予访问性、联系人、日历、提醒事项、位置等权限。

连接您的MCP客户端

在Macuse中：

选择您的传输模式（推荐标准输入输出）。如果使用服务器发送事件/HTTP，请确认绑定地址和端口。

在您的客户端中：

如果客户端支持.mcpb插件
- 复制您的访问令牌。
- 下载并安装macuse.mcpb，然后提供您的访问令牌（如果提示二进制路径，默认为/Applications/Macuse.app/Contents/MacOS/macuse）。
如果客户端不支持.mcpb
- 使用Macuse的一键设置按钮来配置支持的客户端（例如Claude、Cursor、Raycast、AnythingLLM），或
- 复制Macuse生成的配置并粘贴到您的客户端设置中进行手动设置。

手动配置（JSON示例）

通用连接配置（便于复制粘贴）：

标准输入输出

{
  "mode": "stdio",
  "config": {
    "type": "stdio",
    "command": "/Applications/Macuse.app/Contents/MacOS/macuse",
    "args": ["--stdio"],
    "env": { "ACCESS_TOKEN": "<YOUR_TOKEN>" }
  }
}

服务器发送事件

{
  "mode": "sse",
  "config": {
    "type": "sse",
    "url": "http://<BIND_ADDRESS>:<PORT>/sse",
    "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
  }
}

可流式传输HTTP

{
  "mode": "streamableHttp",
  "config": {
    "type": "streamable-http",
    "url": "http://<BIND_ADDRESS>:<PORT>/mcp",
    "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
  }
}

隐私与安全

访问令牌用于本地验证您的客户端到Macuse；它不会发送到远程服务器。
macOS权限（联系人、日历、访问性等）必须由您明确授予。

有用链接

网站：https://macuse.app/
下载：https://macuse.app/download/
模型上下文协议：https://modelcontextprotocol.io/