宏管理服务器

Keyboard Maestro MCP是一个通过自然语言命令管理Keyboard Maestro宏的服务器,适用于需要自动化管理宏的Mac用户。

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

使用说明

键盘大师MCP

键盘大师的MCP服务器。使用自然语言命令管理宏。

你能做什么?

与其浏览菜单和点击按钮,不如问:

说吧。..
“运行我的晨间例行宏”
“创建一个宏,在我按Cmd+Shift+S时键入我的电子邮件签名”
“最近哪些宏失败了?修复它们。”
“复制我的“打开项目”宏并为新客户端修改它”
“禁用我的所有工作宏,我正在度假”

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

真实世界的例子

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

[!重要] 此MCP使您的AI可以完全访问Keyboard Maestro。它可以运行、修改和删除宏。在批准建议的更改之前,请务必对其进行审查。

需求

  • macOS (键盘大师仅适用于macOS)
  • 键盘大师 已安装并正在运行
  • Node.js v18+

快速开始

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

安装向导将自动配置您的AI客户端。它支持:

  • 克劳德桌面版
  • 光标
  • VS代码(副本)
  • 帆板运动
  • 反重力
  • 任何兼容MCP的客户端

可用工具

宏观管理

工具 它做什么
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 搜索引擎日志

测试您的设置

快速检查:

npm run verify

交互式测试:

npx @modelcontextprotocol/inspector node build/index.js

手动配置

如果您更喜欢手动配置,请将此添加到AI客户端的MCP配置中:

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

支持

有问题吗? 在GitHub上打开一个问题

如果你喜欢这个项目,请考虑给回购一个⭐ 明星