Moom MCP

🚀 Moom MCP Server

Moom MCP Serverは、Claude Desktopでの自然言語コマンドを通じて、macOS上のMoomウィンドウレイアウトをプログラムで制御できるModel Context Protocol (MCP)サーバーです。このサーバーを使用することで、ユーザーは自然言語でウィンドウの配置やレイアウトを簡単に操作でき、作業効率を大幅に向上させることができます。

🚀 クイックスタート

このMCPサーバーを使用することで、ClaudeはMac用の強力なウィンドウ管理ツールであるMoomと対話でき、以下のことが可能になります。

• 保存されたウィンドウレイアウトを切り替える
• ピクセル単位の正確さで新しいウィンドウ配置を作成する
• 複数のモニター間でウィンドウの位置とサイズを制御する
• 会話形式のコマンドでワークスペースレイアウトを管理する
• 新機能: 正確なマルチモニター配置のためのDisplayPlacer統合

✨ 主な機能

• 🖼️ activate_layout - 保存された任意のMoomレイアウトに即座に切り替えます。
• 💾 save_current_layout - 現在のウィンドウ配置を再利用可能なレイアウトとして保存します。
• 🎯 trigger_moom_action - Moomのウィンドウアクション（リサイズ、移動、中央配置など）を実行します。
• 📋 show_moom_menu - Moomのポップアップメニューを表示します。
• 🖥️ DisplayPlacer Integration - ピクセル単位の正確なマルチモニターウィンドウ配置を実現します。
• 📐 Precision Layouts - 正確な座標ベースのウィンドウ管理を行います。

📦 インストール

前提条件

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

レイアウトのアクティブ化

• "Switch to my Teaching (Mac Mini) layout"
• "Activate the AI Research Mode workspace"
• "Use my coding layout"
• 新機能: "Switch to DisplayPlacer Coding Pro" (ピクセル単位の正確な配置)

レイアウトの保存

• "Save the current window arrangement as 'Focus Mode'"
• "Create a new layout called 'Video Editing'"

ウィンドウアクション

• "Make this window bigger" (拡大)
• "Center the active window"
• "Move window to the left"
• "Fill the screen with current window"

メニューアクセス

• "Show the Moom menu"
• "Open Moom's layout picker"

マルチモニターの精度 (新機能)

• "Create a DisplayPlacer coding layout" (正確な座標を使用)
• "Position windows with pixel precision"
• "Optimize for my 4K display setup"

高度な使用法

サポートされているウィンドウアクション

• 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                    # メインの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
   

トラブルシューティング

"Error accessing Moom menu"

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

レイアウトがアクティブにならない

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

MCPがClaudeで読み込まれない

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

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

📄 ライセンス

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

👤 作者

Ian Trimble - GitHub

🙏 謝辞

• Many TricksによるMoomの開発
• AnthropicによるModel Context Protocol
• インスピレーションと例を提供してくれたMCPコミュニティ

関連プロジェクト

• Model Context Protocol
• Moom by Many Tricks