Moom MCP Server

Moom MCP Server

自然言語コマンドを使って、Claude Desktop から macOS 上の Moom のウィンドウレイアウトをプログラムで操作できる Model Context Protocol（MCP）サーバーです。

概要

この 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 で自然言語コマンドを使用できます。

レイアウトの切り替え

• 「Teaching (Mac Mini) レイアウトに切り替えて」
• 「AI Research Mode ワークスペースを有効にして」
• 「コーディング用レイアウトを使って」
• 新機能：「DisplayPlacer Coding Pro に切り替えて」（ピクセル単位の精度で配置）

レイアウトの保存

• 「現在のウィンドウ配置を『Focus Mode』として保存して」
• 「『Video Editing』という新しいレイアウトを作成して」

ウィンドウ操作

• 「このウィンドウを大きくして」（拡大）
• 「アクティブなウィンドウを中央に配置して」
• 「ウィンドウを左に移動して」
• 「現在のウィンドウを画面いっぱいに広げて」

メニューへのアクセス

• 「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 Coding Pro：開発向けの精密なレイアウト
• Ultimate Multi-Monitor Pro：すべてのモニターをフル活用

インストール（任意）

brew install jakehilborn/jakehilborn/displayplacer

プロジェクト構成

moom-mcp/
├── src/
│   ├── index.js                    # Main MCP server implementation
│   └── displayplacer-layouts.js    # DisplayPlacer integration module
├── examples.md         # Usage examples and workflows
├── test.js            # Basic functionality tests
├── test-ui.js         # UI automation tests
├── validate.js        # Configuration validator
├── demo.js            # Feature demonstration
├── package.json       # Node.js configuration
├── LICENSE            # MIT License
└── README.md          # This file

開発

テスト

テストスイートを実行します：

npm test          # Basic tests
npm run test-ui   # UI automation tests
npm run validate  # Validate configuration

デバッグ

1. Moom が実行中か確認します：

   pgrep -x Moom
   

2. アクセシビリティ権限が付与されていることを確認します

3. 検証スクリプトを実行します：

   npm run validate
   

トラブルシューティング

「Moom メニューへのアクセスエラー」

• Moom が実行中であることを確認します
• Terminal と Claude Desktop にアクセシビリティ権限が付与されていることを確認します
• Moom のメニューバーアイコンが表示されていることを確認します

レイアウトが有効にならない

• レイアウト名では大文字と小文字が区別されます
• Moom の環境設定で正確なレイアウト名を確認します
• レイアウト名の特殊文字はエスケープが必要な場合があります

Claude で MCP が読み込まれない

• 設定変更後に Claude Desktop を再起動します
• 設定ファイルのパスが絶対パスであることを確認します
• Node.js が PATH に含まれていることを確認します

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストをお送りください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

作者

Ian Trimble - GitHub

謝辞

• Moom を作成した Many Tricks に感謝します
• Model Context Protocol を開発した Anthropic に感謝します
• インスピレーションや事例を提供してくれた MCP コミュニティに感謝します

関連プロジェクト

• Model Context Protocol
• Many Tricks の Moom