CleanShot MCP 服务器（非官方）

通过简单的命令如“截屏”或“捕捉这个区域”，从任何兼容MCP的AI助手控制CleanShot X。

使用了Model Context Protocol (MCP)标准，用于连接AI助手到外部工具。与Amp、Claude Desktop和其他兼容MCP的应用程序兼容。

要求

• macOS
• 已安装并运行的CleanShot X
  • ⚙️ 设置 > 高级 > API > ☑️ 允许应用程序控制CleanShot X
• Node.js 18+

快速开始

1. 安装MCP服务器

# 选项1：无需安装使用（推荐）
npx cleanshot-mcp

# 选项2：全局安装
npm install -g cleanshot-mcp

2. 配置您的MCP客户端

在您的MCP客户端配置中添加以下内容：

{
  "amp.mcpServers": {
    "cleanshot": {
      "command": "npx",
      "args": ["cleanshot-mcp"],
      "env": {}
    }
  }
}

3. 开始使用

只需告诉您的AI助手：

• “截取全屏截图并复制”
• “捕捉这个区域：x: 100, y: 100, 宽度: 500, 高度: 300”
• “打开CleanShot设置”

示例

自然语言命令：

命令	功能
"截取全屏截图并复制"	捕获整个屏幕并复制到剪贴板
"捕捉这个区域：x: 100, y: 100, 宽度: 500, 高度: 300"	捕获特定屏幕区域
"打开CleanShot设置"	打开CleanShot偏好设置
"从这个区域提取文本"	使用OCR从屏幕区域提取文本

可用工具

此MCP服务器提供了17个CleanShot工具，包括：

• 截图：区域捕获、全屏、窗口捕获、定时器
• 录制：自定义区域的屏幕录制
• 文本提取：从任何屏幕区域提取OCR文本
• 标注：为图像打开标注工具
• 管理：历史记录、设置、桌面图标控制

🔧 查看完整工具列表 | 📕 API参考

开发

构建

npm run build

开发模式

npm run dev

测试

确保已安装并运行CleanShot，然后测试各个命令：

# 测试基本功能
node dist/index.js

贡献

1. 分叉仓库
2. 创建功能分支
3. 进行更改
4. 提交拉取请求

支持

• 与此MCP服务器相关的问题：在GitHub上打开问题
• MCP协议问题：MCP文档

[!IMPORTANT] 如果您遇到此MCP服务器的问题，请不要联系CleanShot支持。这是一个由产品粉丝创建的非官方集成。

---

⭐ 给这个仓库点赞 如果您觉得它有用！

使用Amp由Sourcegraph创建