Moom MCP

🚀 Moom MCP 服务器

Moom MCP 服务器是一个基于模型上下文协议（MCP）的服务器，它允许你在 Claude Desktop 中通过自然语言命令，以编程方式控制 macOS 上的 Moom 窗口布局。

🚀 快速开始

MCP 服务器允许 Claude 与强大的 macOS 窗口管理工具 Moom 进行交互，你可以：

• 在保存的窗口布局之间切换
• 以像素级精度创建新的窗口排列
• 跨多个显示器控制窗口的位置和大小
• 通过对话式命令管理你的工作区布局
• 新增：集成 DisplayPlacer 以实现精确的多显示器定位

✨ 主要特性

• 🖼️ activate_layout - 立即切换到任何已保存的 Moom 布局
• 💾 save_current_layout - 将当前窗口排列保存为可重复使用的布局
• 🎯 trigger_moom_action - 执行 Moom 窗口操作（调整大小、移动、居中等等）
• 📋 show_moom_menu - 显示 Moom 弹出菜单
• 🖥️ DisplayPlacer 集成 - 实现像素级的多显示器窗口定位
• 📐 精确布局 - 基于精确坐标的窗口管理

📦 安装指南

前提条件

• macOS（10.12 或更高版本）
• 已安装并运行 Moom
• Node.js 14 或更高版本
• Claude Desktop 应用程序
• 具有辅助功能权限的终端应用程序
• 可选：DisplayPlacer，用于增强多显示器支持

安装步骤

1. 克隆此仓库：

   git clone https://github.com/itrimble/moom-mcp.git
   cd moom-mcp
   

2. 安装依赖项：

   npm install
   

3. 授予辅助功能权限：

   • 打开 系统偏好设置 → 安全性与隐私 → 隐私 → 辅助功能
   • 添加并启用终端（或你的终端应用程序）
   • 添加并启用 Claude Desktop

4. 添加到 Claude Desktop 配置：

   • 打开 Claude Desktop
   • 导航到设置 → 开发者 → 编辑配置
   • 将以下内容添加到你的 claude_desktop_config.json 中：

   {
     "mcpServers": {
       "moom": {
         "command": "node",
         "args": ["/absolute/path/to/moom-mcp/src/index.js"]
       }
     }
   }
   

5. 重启 Claude Desktop

💻 使用示例

安装完成后，你可以在 Claude Desktop 中使用自然语言命令：

激活布局

• "切换到我的教学（Mac Mini）布局"
• "激活人工智能研究模式工作区"
• "使用我的编码布局"
• 新增："切换到 DisplayPlacer 编码专业版布局"（像素级精确定位）

保存布局

• "将当前窗口排列保存为 '专注模式'"
• "创建一个名为 '视频编辑' 的新布局"

窗口操作

• "放大此窗口"（增大窗口尺寸）
• "将活动窗口居中"
• "将窗口向左移动"
• "用当前窗口填充屏幕"

菜单访问

• "显示 Moom 菜单"
• "打开 Moom 的布局选择器"

多显示器精度（新增）

• "创建一个 DisplayPlacer 编码布局"（使用精确坐标）
• "以像素精度定位窗口"
• "针对我的 4K 显示器设置进行优化"

可用命令

支持的窗口操作

• grow - 增大窗口尺寸
• shrink - 减小窗口尺寸
• move-left - 将窗口向左移动
• move-right - 将窗口向右移动
• move-up - 将窗口向上移动
• move-down - 将窗口向下移动
• center - 将窗口在屏幕上居中
• fill-screen - 最大化窗口

📚 详细文档

DisplayPlacer 集成

服务器现在使用 DisplayPlacer 提供高级多显示器支持：

优点

• 像素级精确定位：使用精确的显示器坐标
• 多显示器感知：进行正确的原点计算
• 4K 显示器优化：考虑缩放因素
• 高刷新率支持（120Hz 以上）
• 负坐标处理：适用于左侧位置的显示器

增强布局

• DisplayPlacer 编码专业版：用于开发的精确布局
• 终极多显示器专业版：充分利用所有显示器

安装（可选）

brew install jakehilborn/jakehilborn/displayplacer

项目结构

moom-mcp/
├── src/
│   ├── index.js                    # 主 MCP 服务器实现
│   └── displayplacer-layouts.js    # DisplayPlacer 集成模块
├── examples.md         # 使用示例和工作流程
├── test.js            # 基本功能测试
├── test-ui.js         # UI 自动化测试
├── validate.js        # 配置验证器
├── demo.js            # 功能演示
├── package.json       # Node.js 配置
├── LICENSE            # MIT 许可证
└── README.md          # 本文件

开发

测试

运行测试套件：

npm test          # 基本测试
npm run test-ui   # UI 自动化测试
npm run validate  # 验证配置

调试

1. 检查 Moom 是否正在运行：

   pgrep -x Moom
   

2. 验证是否已授予辅助功能权限

3. 运行验证脚本：

   npm run validate
   

故障排除

"访问 Moom 菜单时出错"

• 确保 Moom 正在运行
• 验证终端和 Claude Desktop 的辅助功能权限
• 检查 Moom 的菜单栏图标是否可见

布局未激活

• 布局名称区分大小写
• 验证 Moom 偏好设置中的精确布局名称
• 布局名称中的特殊字符可能需要转义

MCP 未在 Claude 中加载

• 配置更改后重启 Claude Desktop
• 检查配置文件路径是否为绝对路径
• 验证 Node.js 是否在你的 PATH 中

🤝 贡献

欢迎贡献代码！请随时提交拉取请求。

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

👨‍💻 作者

Ian Trimble - GitHub

🙏 致谢

• Many Tricks 开发了 Moom
• Anthropic 提供了模型上下文协议
• MCP 社区提供了灵感和示例

🔗 相关项目

• 模型上下文协议
• Many Tricks 开发的 Moom