截图控制服务

通过MCP协议兼容的AI助手控制CleanShot X进行截图、录屏、OCR等操作的服务

  • by jdorfman
  • JavaScript
  • 本地部署
  • 15 星标
  • 更新于
在 GitHub 查看 jdorfman/cleanshot-mcp

使用说明

CleanShot MCP服务器(非官方)

通过任何与MCP兼容的AI助手,使用“截图”或“捕获此区域”等简单命令控制CleanShot X。

与 模型上下文协议(MCP) -将AI助手连接到外部工具的标准。使用 安培Claude Desktop和其他MCP兼容应用程序。

需求

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

快速开始

1.安装MCP服务器

# Option 1: Use without installing (recommended)
npx cleanshot-mcp

# Option 2: Install globally
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已安装并正在运行,然后测试各个命令:

# Test basic functionality
node dist/index.js

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 提交拉取请求

支持

[!重要] 请 不要 有关此MCP服务器的问题,请联系CleanShot支持。这是由他们产品的粉丝创建的非官方集成。


⭐ 标记此回购 如果你觉得它有用的话!

创建于 安培 来源图