moom-mcp - 借助MCP协议实现Moom macOS窗口管理工具程序化控制及多屏布局集成

探索

Moom MCP

一个MCP服务器项目，通过自然语言命令实现对macOS窗口管理工具Moom的程序化控制，包括切换布局、保存窗口排列、精确窗口定位等功能，并新增DisplayPlacer集成支持多显示器精确布局。

操作系统自动化开发者工具 #窗口管理 #自然语言控制 #多屏布局 #macOS工具 .JavaScript

评分 : 2分

下载量 : 6.0K

更新时间 : 2025-07-25

打开站点

什么是Moom MCP Server?

这是一个连接Claude人工智能与Moom窗口管理工具的桥梁服务，让您可以用日常对话的方式控制电脑窗口布局。无论是切换预设布局还是创建新工作区，都能通过简单对话完成。

如何使用Moom MCP Server?

安装配置后，直接在Claude聊天窗口输入自然语言指令即可。比如'切换到编程布局'或'把当前窗口移到右边'，系统会自动转换为Moom操作。

适用场景

特别适合需要频繁切换工作环境的用户，如开发者、设计师、视频编辑等。多显示器用户更能体验其精准布局优势。

主要功能

布局快速切换

一键激活预设窗口布局，支持多显示器配置

布局保存

随时保存当前窗口排列，创建个性化工作区

窗口精细控制

支持移动/缩放/居中/最大化等常见窗口操作

多显示器精准控制

集成DisplayPlacer实现像素级多显示器窗口定位

优势

无需记忆快捷键，自然语言控制

保留Moom所有功能的同时提升易用性

特别适合复杂多显示器环境

与Claude无缝集成，智能理解用户意图

局限性

仅支持macOS系统

需要预先安装Moom软件

首次配置需要授予系统权限

如何使用

安装准备

确保已安装Moom和Node.js，克隆项目仓库

权限配置

在系统设置中为Terminal和Claude Desktop启用辅助功能权限

Claude配置

在Claude设置中添加MCP服务器配置并重启应用

使用案例

快速切换工作模式

在不同任务间无缝切换预设布局

临时保存窗口排列

遇到理想的临时窗口排列时快速保存

多显示器精准控制

为不同显示器配置优化窗口布局

常见问题

为什么我的命令没有生效？

如何知道可用的布局名称？

DisplayPlacer是必须安装的吗？

🚀 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，用于增强多显示器支持

安装步骤

克隆此仓库：

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

安装依赖项：

npm install

授予辅助功能权限：

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

添加到 Claude Desktop 配置中：

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

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

重启 Claude Desktop

💻 使用示例

基础用法

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

激活布局

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

保存布局

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

窗口操作

"放大这个窗口"（增大窗口大小）
"将活动窗口居中"
"将窗口向左移动"
"用当前窗口填充屏幕"

菜单访问

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

多显示器精确控制（新增）

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

可用命令

命令	描述	示例
`activate_layout`	切换到保存的 Moom 布局	`{ "layoutName": "Teaching (Mac Mini)" }`
`save_current_layout`	保存当前的窗口排列	`{ "layoutName": "Development Setup" }`
`trigger_moom_action`	执行窗口操作	`{ "action": "center" }`
`show_moom_menu`	显示 Moom 弹出菜单	`{}`

支持的窗口操作

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  # 验证配置

调试

检查 Moom 是否正在运行：

pgrep -x Moom

验证是否已授予辅助功能权限
运行验证脚本：

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