mcp-pyautogui-サーバー

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

特徴

• マウスの動きとクリックを制御する

• キーボード入力をシミュレートする

• スクリーンショットを撮る

• 画面上の画像を見つける

• 画面情報を取得する

• クロスプラットフォームサポート（Windows、macOS、Linux）

Related MCP server: Computer Use MCP

ツール

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

マウスコントロール

• マウスを特定の座標に移動する

• 現在の位置または指定した位置をクリック

• ドラッグアンドドロップ操作

• 現在のマウスの位置を取得する

キーボードコントロール

• テキストを入力

• 個々のキーを押す

• ホットキーの組み合わせ

画面操作

• スクリーンショットを撮る

• 画面サイズを取得する

• 画面上の画像の位置を見つける

• ピクセルカラーを取得する

インストール

前提条件

• Python 3.12以上

• PyAutoGUI

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

インストール手順

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

pip install mcp-pyautogui-server

クロードデスクトップ構成

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

インスペクターには、ブラウザでアクセスしてデバッグを開始できる URL が表示されます。

ライセンス

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