内容
# maus-mcp
为 **Claude Code**、**Cursor**、**Codex** 等 MCP 客户端提供访问您 **[Maus](https://mausformac.com)** 剪贴板的功能，适用于 macOS。
本地运行，无云服务。剪贴板内容不会离开您的 Mac。自动尊重您的 Maus 级别（免费 vs 专业）。
## 为什么
当 Claude 给您写电子邮件、SQL 查询、正则表达式或代码片段时，从聊天终端复制内容会带入单间距格式、Markdown 星号和多余的空格到您的目标应用程序。
使用 Maus + 此 MCP，代理可以直接将文本 **放入您的 Maus 历史记录**。您从 Maus 粘贴到 Mail / Slack / 任意位置 - 清洁。
它还允许代理搜索、列出和整理您的剪贴板历史记录，包括截图的 OCR 文本。
## 要求
- **macOS**（Maus 仅适用于 macOS；此 MCP 读取其本地 SQLite 数据库）。
- **[Maus](https://mausformac.com)** 已安装并运行。
- **Node.js ≥ 20**。
## 安装
### Claude Code
```bash
claude mcp add -s user maus -- npx maus-mcp@latest
```
`-s user` 标志全局安装 Maus 以便在每个项目中使用。如果没有此标志，MCP 只会在您运行命令的目录中加载。
重启 Claude Code（关闭所有会话，打开新会话）并尝试：
> *"Maus，显示我最近 5 个剪贴板项目"*
### Cursor
将以下内容添加到您的 Cursor MCP 配置文件 (`~/.cursor/mcp.json`)：
```json
{
"mcpServers": {
"maus": {
"command": "npx",
"args": ["maus-mcp@latest"]
}
}
}
```
### 其他 MCP 客户端
任何支持 [Model Context Protocol](https://modelcontextprotocol.io) 标准输入/输出传输的客户端。直接运行 `npx maus-mcp@latest`。
## 工具
| 工具 | 功能 |
|---|---|
| `list_recent` | 按时间顺序列出最新项目，支持筛选。 |
| `search` | 在内容、标题、源应用程序、URL 和 **截图的 OCR 文本** 中进行子字符串搜索。 |
| `get` | 按 ID 获取一个项目。对于图像：返回 OCR + 精简的 JPEG。 |
| `set_title` | 重命名一个项目。允许代理组织剪贴板。 |
| `forget` | 永久删除一个项目（按 ID）或多个项目（按筛选）。 |
| `add_item` | 在 Maus 历史记录中写入一个干净的文本项目。仅 Maus 专业版支持。 |
## 专业版 vs 免费版
MCP 严格遵循您的 Maus 级别：
- **免费版**：可以访问最近 24 小时的历史记录。
- **专业版**：可以访问所有历史记录 + 高级筛选（`source_apps`、`content_patterns`）+ 写入（`add_item`）。
当代理请求超出您的级别时，响应会携带升级链接，以便代理可以在上下文中提供。
[升级到 Maus 专业版 →](https://mausformac.lemonsqueezy.com/checkout/buy/fa311099-77f7-4b0d-8d39-eab756710f15)
## 隐私
Maus MCP 不会将您的剪贴板内容发送到任何地方。不会查询标题、项目文本。
服务器会报告匿名使用情况（调用了哪个工具、耗时、您的 Maus 级别），以便维护者了解使用情况和问题。您可以通过设置 `MAUS_MCP_TELEMETRY=off` 来退出。
## 开发
```bash
git clone https://github.com/mausformac/maus-mcp.git
cd maus-mcp
npm install
npm run dev # 使用 tsx（实时 TypeScript）运行
npm run build # 编译到 dist/
```
在没有 MCP 客户端的情况下手动测试：
```bash
node test_get.mjs
node test_list_recent.mjs
node test_search.mjs
node test_set_title.mjs
node test_forget.mjs
MAUS_MCP_TIER_OVERRIDE=pro node test_add_item.mjs
```
## License
[MIT](./LICENSE)
## 链接
- [Maus](https://mausformac.com)
- [Model Context Protocol](https://modelcontextprotocol.io)
- [报告问题](https://github.com/mausformac/maus-mcp/issues)
