Swiftautogui

🚀 Swift MCP GUI サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）サーバーで、SwiftAutoGUI を通じて Mac OS X を制御することを可能にします。MCP クライアントには、macOS のマウスとキーボードを制御するためのツールが提供されます。

🚀 クイックスタート

このサーバーを使用することで、MCP クライアントから macOS のマウスとキーボードを制御できます。以下に必要条件、インストール手順、利用可能なツールなどを説明します。

✨ 主な機能

• macOS のマウスとキーボードを制御する機能を提供
• MCP クライアントとの連携が可能

📦 インストール

必要条件

• macOS 15.0 以上
• Swift 6.0 以上
• Xcode 16.0 以上

インストール手順

1. このリポジトリをクローンします。

git clone https://github.com/NakaokaRei/swift-mcp-gui.git
cd swift-mcp-gui

2. インストールを行います。

swift package experimental-install

3. コマンドを MCP クライアントに追加します。

{
  "mcpServers" : {
    "swift-mcp-gui" : {
      "command" : "/Users/USERNAME/.swiftpm/bin/swift-mcp-gui"
    }
  }
}

💻 使用例

基本的な使用法

このサーバーは、以下のツールを提供して macOS を制御できます。

1. マウス移動

• ツール名：moveMouse
• 入力：
  • x: Double（x 座標）
  • y: Double（y 座標）
• 指定した座標にマウスポインタを移動します。

2. マウスクリック

• ツール名：mouseClick
• 入力：
  • button: String（"left" または "right"）
• 現在のカーソル位置でマウスクリックを実行します。

3. キーボード入力

• ツール名：sendKeys
• 入力：
  • keys: String 配列（キー名）
• キーボードのショートカットまたはキーの組み合わせを送信します。
• キーの例： "command", "control", "option", "shift", "return", "space", "a", "1" など

4. スクロール

• ツール名：scroll
• 入力：
  • direction: String（"up", "down", "left", "right"）
  • clicks: Int（スクロール回数）
• 指定した方向にスクロール操作を実行します。

⚠️ 重要提示

このサーバーは、あなたのマウスとキーボードを完全に制御することができます。慎重に実行し、信頼できる MCP クライアントにのみ接続してください。

📄 ライセンス

MIT License