使用说明
键盘大师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上打开一个问题
如果你喜欢这个项目,请考虑给回购一个⭐ 明星
