AI导哈

键盘宏控制服务

一个连接AI助手与Keyboard Maestro的MCP服务器，用于触发宏、捕获剪贴板内容和控制多台Mac机器。

  • by akari2600
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 akari2600/keyboard-maestro-mcp

使用说明

键盘大师MCP服务器

一个MCP（模型上下文协议）服务器，将克劳德等人工智能助手连接到 键盘大师，使它们能够触发宏并从Mac检索剪贴板结果。

它的作用

此MCP服务器允许AI助手：

  • 触发宏 在一台或多台Mac上
  • 捕获剪贴板内容 （文本和图像）来自宏
  • 截图 并对其进行分析
  • 运行OCR 并提取文本
  • 控制多台机器 从单一配置

当你运行一个宏将某些内容复制到剪贴板（如屏幕截图）时，人工智能可以直接检索和查看这些内容。

需求

  • macOS与 键盘大师 11+已安装
  • 键盘Maestro Web服务器已启用
  • Node.js 18+

快速开始

1.添加MCP服务器

添加到MCP客户端配置中：

克劳德桌面版 (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "keyboard-maestro": {
      "command": "npx",
      "args": ["-y", "keyboard-maestro-mcp"]
    }
  }
}

克劳德代码 (~/.claude/mcp.json):

{
  "keyboard-maestro": {
    "command": "npx",
    "args": ["-y", "keyboard-maestro-mcp"]
  }
}

2.运行配置工具

添加服务器并重新启动MCP客户端后，询问AI：

Open the Keyboard Maestro config tool

配置工具将指导您完成以下操作：

  1. 启用Web服务器 -键盘大师Web服务器设置说明
  2. 添加机器 -输入连接详细信息并测试连接
  3. 更新配置 -自动更新MCP配置文件（或复制JSON）
  4. 安装宏 -生成并导入所需的Keyboard Maestro宏

配置参考

环境变量

配置机器时，服务器使用以下环境变量：

变量 描述
KM_MACHINES 机器配置的JSON数组

或者对于一台机器：

变量 必填 默认 描述
KM_HOST 是 - 主机名或IP地址
KM_PORT 无 4490 Web服务器端口
KM_USERNAME 是 - Web服务器用户名
KM_PASSWORD 是 - Web服务器密码
KM_SECURE 否 错误 使用HTTPS而不是HTTP
KM_NAME 否 主机值 计算机的友好名称
KM_OUTPUT_DIR 是 - 保存剪贴板文件的文件夹

机器配置对象

每台机器 KM_MACHINES 支持：

字段 必填 默认 描述
name 是 - 机器的友好名称
host 是 - 主机名或IP地址
port 无 4490 Web服务器HTTP端口
username 是 - Web服务器用户名
password 是 - Web服务器密码
secure 否 错误 使用HTTPS而不是HTTP
outputDir 是 - 保存剪贴板文件的文件夹

端口间距： Keyboard Maestro使用两个连续端口（端口+1上的HTTP和HTTPS）。配置多台机器时，将端口间隔至少2个（例如，4490、4492、4494）。

可用工具

交互式配置

带有交互式UI的可视化配置工具（适用于Claude Desktop和其他支持客户端的MCP应用程序）。提供：

  • 机器管理（添加、编辑、删除、测试）
  • MCP配置文件更新
  • 宏组生成和安装

配置

基于文本的配置工具（适用于Claude Code和其他CLI客户端）。

list_machines

列出所有已配置的Keyboard Maestro机器。

list_macros

列出计算机中可用的宏。

触发器_宏

按名称或UUID触发宏。

trigger_macro_on_all

在所有已配置的计算机上同时触发宏。

get_clipboard_result

从计算机检索当前剪贴板内容。

触发和捕获

触发宏并自动捕获剪贴板结果。

示例工作流

屏幕截图分析

Take a screenshot of the active window and describe what you see

OCR文本提取

Run OCR on my clipboard image and read the text

多机控制

Mute audio on all my machines

键盘大师设置

配置工具将为您提供指导，但以下是摘要：

启用Web服务器

  1. 打开 键盘大师
  2. 首选 键盘大师→ 偏好 (⌘,)
  3. 点击 Web服务器 标签
  4. 检查 Web服务器已启用
  5. 设定一个 用户名 和 密码
  6. 注意 http端口 （默认值：4490）

导入宏

使用配置工具生成宏后：

  1. 首选 File → 导入→ 安全导入宏。..
  2. 选择已下载的 keyboard-maestro-mcp.kmmacros 文件
  3. 将出现“键盘大师MCP”组

安全考虑

  • 凭据通过环境变量传递
  • 使用HTTPS(secure: true)通过不受信任的网络连接时
  • web服务器使用HTTP基本身份验证
  • 考虑防火墙规则来限制对web服务器端口的访问
  • 剪贴板文件存储在您配置的文件夹中

故障排除

“连接被拒绝”错误

  • 验证键盘大师的web服务器是否已启用
  • 检查端口号是否与您的配置匹配
  • 确保没有防火墙阻止连接

宏未出现在列表中

  • 必须启用宏
  • 必须启用宏组
  • 宏必须有一个名称

剪贴板捕获不返回任何内容

  • 运行配置工具以验证是否安装了宏
  • 检查一下 outputDir 指向宏中配置的同一文件夹
  • 确保文件夹存在并且可写

许可证

麻省理工学院

相关 MCP