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