Moom MCP

🚀 Moom MCP Server

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

🚀 快速开始

Moom MCP Server 让 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 社区提供了灵感和示例

相关项目

• Model Context Protocol
• Moom by Many Tricks