键盘大师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"]
}
}
}支持
有问题吗？
如果你喜欢这个项目，请考虑给回购一个⭐ 明星
