macos-workspace-mcp-server by rukawa07 - MCP Server

macOS Workspace MCP Server

macOS用のMCPサーバーで、macOSのアプリケーションとウィンドウを制御し、ユーザーのワークスペース管理を自動化します。

Model Context Protocol (MCP)は、AIアプリケーションと外部システムを接続するためのオープン標準です。

概要

Swift 6.0とMCP Swift SDKで実装されたMCPサーバーです。AIアシスタントから以下を自動化できます。

アプリ制御: 起動・終了・起動中一覧
ウィンドウ管理: 位置・サイズ調整、フォーカス、情報取得
マルチディスプレイ: ディスプレイ間の移動・配置
プリセット配置: 左/右/上下半分、4分割、3分割、全画面、中央寄せ

Tools（MCP Server Tool一覧）

このサーバーは以下のMCPツールを提供します。各ツールは Tools/ 配下に実装され、ToolRegistryで登録されています。

launch_application
quit_application
list_applications
list_windows
position_window
focus_window
list_displays

launch_application

概要: Bundle IDでアプリを起動（起動済みなら前面化）。
パラメーター: bundleId（必須、例: com.apple.Safari）
戻り値例:

{ "processId": 12345, "appName": "Safari", "wasAlreadyRunning": false }

quit_application

概要: 指定アプリを終了（保存ダイアログはOS標準に従う）。
パラメーター: bundleId（必須）
戻り値例:

{ "appName": "Safari", "quitSuccessfully": true }

list_applications

概要: 起動中アプリ一覧（UIを持つプロセスのみ）。
戻り値例:

{ "applications": [ { "bundleId": "com.apple.Safari", "name": "Safari", "processId": 12345 } ] }

list_windows

概要: ウィンドウ情報（タイトル、位置、サイズ、状態、ディスプレイ）。
パラメーター: bundleId（任意。指定時はそのアプリのみ）
戻り値例:

{ "windows": [ { "title": "ドキュメント.txt", "x": 100, "y": 200, "width": 800, "height": 600, "isMinimized": false, "isFullscreen": false, "displayId": 1 } ] }

position_window

概要: プリセットに基づくウィンドウ配置。
パラメーター:
- bundleId（必須）
- preset（必須。例: left-half, right-half, top-left, left-third, fullscreen, centerなど）
- title（任意）
- displayName（任意）
戻り値例:

{ "windowTitle": "ドキュメント.txt", "newPosition": { "x": 0, "y": 23 }, "newSize": { "width": 960, "height": 1057 } }

focus_window

概要: 指定ウィンドウを最前面化。
パラメーター: bundleId（必須）、title（任意）
戻り値例:

{ "windowTitle": "Safari", "focusSuccessfully": true }

list_displays

概要: 接続中ディスプレイ情報取得。
戻り値例:

{ "displays": [ { "id": 1, "name": "Built-in Display", "bounds": { "x": 0, "y": 0, "width": 1920, "height": 1080 }, "workArea": { "x": 0, "y": 23, "width": 1920, "height": 1057 }, "isPrimary": true } ] }

セットアップ

前提条件

macOS: 15.0以上
Xcode: 16.1以上（Swift 6.0対応）
アクセシビリティ権限: システム設定 > プライバシーとセキュリティ > アクセシビリティで許可

ビルド

# Debugビルド（開発・デバッグ用）
swift build

# Releaseビルド（本番用、最適化あり）
swift build -c release

実行・クライアント設定（Claude Desktop）

Claude DesktopのMCPサーバー設定ファイルに以下を追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "workspace": {
      "command": "/path/to/MacOSWorkspaceMCPServer/.build/release/MacOSWorkspaceMCPServer"
    }
  }
}

手動実行（開発・テスト）

# Debugビルドの実行
.build/debug/MacOSWorkspaceMCPServer

# Releaseビルドの実行
.build/release/MacOSWorkspaceMCPServer

サーバーは標準入出力（stdio）でMCPクライアントからのJSON-RPC通信を待機します。

使用例

「Safariを起動して」
「VS Codeのウィンドウを左半分に配置して」
「接続されているディスプレイを教えて」
「起動中のアプリケーション一覧を見せて」
「Slackのウィンドウを右側2/3に配置して」
「すべてのFinderウィンドウを表示して」

技術スタック

カテゴリ	技術	バージョン
言語	Swift	6.0
SDK	MCP Swift SDK	0.10.0+
プラットフォーム	macOS	15.0+
API	Accessibility API	-
ビルドツール	Swift Package Manager	-
テスト	Swift Testing	-
通信	StdioTransport (JSON-RPC)	-

rukawa07/macos-workspace-mcp-server