mcp-pyautogui-server

mcp-pyautogui-server

PyAutoGUI を通じて、自動 GUI テストと制御機能を提供する MCP（Model Context Protocol）サーバーです。

機能

• マウスの移動とクリックを制御
• キーボード入力をシミュレート
• スクリーンショットを撮影
• 画面上の画像を検索
• 画面情報を取得
• クロスプラットフォームに対応（Windows、macOS、Linux）

ツール

このサーバーは次のツールを実装しています。

マウス制御

• 指定した座標にマウスを移動
• 現在の位置または指定した位置をクリック
• ドラッグ＆ドロップ操作
• 現在のマウス位置を取得

キーボード制御

• テキストを入力
• 個々のキーを押す
• ホットキーの組み合わせ

画面操作

• スクリーンショットを撮影
• 画面サイズを取得
• 画面上の画像の位置を検索
• ピクセルの色を取得

インストール

前提条件

• Python 3.12+
• PyAutoGUI
• その他の依存関係は自動的にインストールされます

インストール手順

パッケージをインストールします。

pip install mcp-pyautogui-server

Claude Desktop の設定

MacOS の場合：

~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows の場合：

%APPDATA%/Claude/claude_desktop_config.json

開発版／未公開サーバーの設定：

{
  "mcpServers": {
    "mcp-pyautogui-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-pyautogui-server",
        "run",
        "mcp-pyautogui-server"
      ]
    }
  }
}

公開済みサーバーの設定：

{
  "mcpServers": {
    "mcp-pyautogui-server": {
      "command": "uvx",
      "args": [
        "mcp-pyautogui-server"
      ]
    }
  }
}

開発

ビルドと公開

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. パッケージの配布ファイルをビルドします。

uv build

3. PyPI に公開します。

uv publish

注：環境変数またはコマンドフラグで PyPI の認証情報を設定します。

• トークン：--token または UV_PUBLISH_TOKEN
• ユーザー名／パスワード：--username／UV_PUBLISH_USERNAME および --password／UV_PUBLISH_PASSWORD

デバッグ

最適なデバッグ体験を得るには、MCP Inspector を使用してください。

npm で MCP Inspector を起動します。

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-pyautogui-server run mcp-pyautogui-server

Inspector に URL が表示されます。ブラウザーでその URL にアクセスすると、デバッグを開始できます。

ライセンス

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