keyboard-maestro-mcp

🚀 Keyboard Maestro MCP

Keyboard Maestro MCP 是一个为 Keyboard Maestro 打造的 MCP 服务器，可让你通过自然语言命令来管理宏。

🚀 快速开始

git clone https://github.com/saihgupr/keyboard-maestro-mcp.git
cd keyboard-maestro-mcp
npm install
npm run setup

设置向导会自动配置你的 AI 客户端，它支持以下客户端：

• Claude Desktop
• Cursor
• VS Code (Copilot)
• Windsurf
• Antigravity
• 任何兼容 MCP 的客户端

✨ 主要特性

你无需再翻找菜单、点击按钮，只需直接发出指令，例如： | 只需说... | |-------------| | "运行我的早晨例行宏" | | "创建一个宏，当我按下 Cmd + Shift + S 时输入我的电子邮件签名" | | "最近哪些宏运行失败了？修复它们" | | "复制我的 '打开项目' 宏，并为新客户进行修改" | | "禁用我所有的工作宏，我在休假" |

你的 AI 助手将成为你 Mac 的高级用户，它可以通过对话读取、创建、修改、运行和调试你的 Keyboard Maestro 宏。

📦 安装指南

要求

• macOS（Keyboard Maestro 仅支持 macOS）
• 已安装并运行 Keyboard Maestro
• Node.js v18+

💻 使用示例

实际用例

| 用例 | 示例 | |----------|---------| | 调试 | "我的剪贴板管理器宏昨天停止工作了。查看日志并告诉我出了什么问题。" | | 批量编辑 | "我有 20 个打开 Chrome 的宏。将它们全部改为打开 Arc。" | | 快速自动化 | "创建一个宏，当我连接到家庭 WiFi 时挂载我的 NAS 驱动器。" | | 组织管理 | "创建一个名为 '客户工作' 的新宏组，并将所有名称中包含 'ACME' 的宏移动到其中。" |

测试设置

快速检查

npm run verify

交互式测试

npx @modelcontextprotocol/inspector node build/index.js

📚 详细文档

可用工具

宏管理

| 工具 | 功能 | |------|--------------| | km_search_macros | 按名称查找宏 | | km_list_macros | 列出所有宏 | | km_get_macro | 获取宏的详细信息 | | km_get_macro_xml | 导出宏的完整定义 | | km_create_macro | 创建新宏 | | km_clone_macro | 复制现有宏 | | km_delete_macro | 删除宏 | | km_enable_macro | 开启/关闭宏 | | km_run_macro | 立即执行宏 | | km_manage_group | 组织宏组 |

操作编辑

| 工具 | 功能 | |------|--------------| | km_list_actions | 查看宏中的所有步骤 | | km_add_action | 添加新步骤 | | km_move_action | 重新排序步骤 | | km_delete_action | 删除步骤 | | km_get_action_xml | 导出步骤的定义 | | km_set_action_xml | 替换步骤 | | km_search_replace_action | 在步骤中查找并替换文本 |

触发器编辑

| 工具 | 功能 | |------|--------------| | km_add_trigger | 添加新触发器 | | km_delete_trigger | 删除触发器 | | km_get_trigger_xml | 导出触发器 | | km_set_trigger_xml | 替换触发器 |

变量和日志

| 工具 | 功能 | |------|--------------| | km_manage_variable | 读取、写入或删除 KM 变量 | | km_get_errors | 查找最近的宏失败情况 | | km_get_log | 搜索引擎日志 |

手动配置

如果你更喜欢手动配置，可以将以下内容添加到你的 AI 客户端的 MCP 配置中：

{
  "mcpServers": {
    "keyboard-maestro": {
      "command": "node",
      "args": ["/path/to/keyboard-maestro-mcp/build/index.js"]
    }
  }
}

📄 许可证

文档中未提及相关信息，跳过该章节。

⚠️ 重要提示

此 MCP 会让你的 AI 完全访问 Keyboard Maestro，它可以运行、修改和删除宏。在批准建议的更改之前，请始终进行审核。

支持

如果你遇到问题，请 在 GitHub 上提交问题。

如果你喜欢这个项目，请考虑给仓库点个 ⭐ 赞！