Swift MCP Gui

🚀 Swift MCP GUI サーバー

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

🚀 クイックスタート

Swift MCP GUI サーバーを使用することで、Mac OS X 上でマウスとキーボードをプログラムで制御できます。以下に、セットアップと使用方法を説明します。

✨ 主な機能

• マウスの移動、クリック、スクロール操作をプログラムで制御できます。
• キーボードの入力をプログラムで送信できます。

📦 インストール

必要条件

• 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 ライセンスの下で公開されています。