computer-control-mcp 0.1.0__tar.gz

computer_control_mcp-0.1.0/.gitattributes

@@ -0,0 +1,18 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+
+# Python files
+*.py text diff=python
+
+# Documentation
+*.md text
+*.rst text
+*.txt text
+
+# Exclude files from exporting
+.gitattributes export-ignore
+.gitignore export-ignore
+.github export-ignore
+.pytest_cache export-ignore
+__pycache__ export-ignore
+*.pyc export-ignore

computer_control_mcp-0.1.0/.gitignore

@@ -0,0 +1,52 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# Distribution / packaging
+.Python
+develop-eggs/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Environments
+.env
+
+# IDE files
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS specific files
+.DS_Store
+Thumbs.db

computer_control_mcp-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

computer_control_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Computer Control MCP Authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

computer_control_mcp-0.1.0/MANIFEST.in

@@ -0,0 +1,10 @@
+include README.md
+include LICENSE
+include pyproject.toml
+recursive-include src *
+recursive-include tests *
+recursive-include docs *
+global-exclude *.pyc
+global-exclude __pycache__
+global-exclude *.so
+global-exclude .DS_Store

computer_control_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: computer-control-mcp
+Version: 0.1.0
+Summary: Computer control capabilities using PyAutoGUI through a Model Context Protocol (MCP) server
+Project-URL: Homepage, https://github.com/AB498/computer-control-mcp
+Project-URL: Issues, https://github.com/AB498/computer-control-mcp/issues
+Project-URL: Documentation, https://github.com/AB498/computer-control-mcp#readme
+Author-email: Computer Control MCP Authors <example@example.com>
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Requires-Dist: mcp[cli]
+Requires-Dist: pillow
+Requires-Dist: pyautogui
+Requires-Dist: pygetwindow
+Requires-Dist: watchdog
+Description-Content-Type: text/markdown
+
+# Computer Control MCP
+
+A Python package that provides computer control capabilities using PyAutoGUI through a Model Context Protocol (MCP) server.
+
+## Project Structure
+
+```
+computer-control-mcp/
+├── docs/                  # Documentation
+│   ├── index.md          # Main documentation
+│   └── api.md            # API reference
+├── src/                  # Source code
+│   └── computer_control_mcp/  # Main package
+│       ├── __init__.py   # Package initialization
+│       ├── __main__.py   # Entry point for running as a module
+│       ├── core.py       # Core functionality
+│       ├── cli.py        # Command-line interface
+│       └── gui.py        # GUI for testing
+├── tests/                # Test files
+│   ├── conftest.py       # Pytest configuration
+│   └── test_computer_control.py  # Tests for core functionality
+├── LICENSE               # MIT license
+├── MANIFEST.in           # Package manifest
+├── pyproject.toml        # Project configuration
+└── README.md            # This file
+```
+
+## Installation
+
+```bash
+pip install computer-control-mcp
+```
+
+Or with uv:
+
+```bash
+uv pip install computer-control-mcp
+```
+
+## Features
+
+- Control mouse movements and clicks
+- Type text at the current cursor position
+- Take screenshots of the entire screen or specific windows
+- List and activate windows
+- Press keyboard keys
+- Drag and drop operations
+
+## Usage
+
+### Basic Example
+
+```python
+from computer_control_mcp.core import mcp
+
+# Click at specific coordinates
+mcp.click_screen(x=100, y=100)
+
+# Type text
+mcp.type_text(text="Hello, world!")
+
+# Take a screenshot
+screenshot = mcp.take_screenshot(mode="whole_screen")
+```
+
+### Command-line Interface
+
+```bash
+# Run the MCP server
+computer-control-mcp server
+
+# Click at coordinates
+computer-control-mcp click 100 100
+
+# Type text
+computer-control-mcp type "Hello, world!"
+
+# Take a screenshot
+computer-control-mcp screenshot --mode whole_screen
+
+# List all windows
+computer-control-mcp list-windows
+
+# Launch the GUI test harness
+computer-control-mcp gui
+```
+
+### Running as a Module
+
+You can run the package as a module:
+
+```bash
+python -m computer_control_mcp
+```
+
+## Development
+
+### Setting up the Development Environment
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/computer-control-mcp.git
+cd computer-control-mcp
+
+# Create a virtual environment and install dependencies
+python -m venv .venv
+.venv\Scripts\activate  # On Windows
+source .venv/bin/activate  # On Unix/macOS
+
+# Install in development mode
+pip install -e .
+```
+
+### Running Tests
+
+```bash
+python -m pytest
+```
+
+## API Reference
+
+See the [API Reference](docs/api.md) for detailed information about the available functions and classes.
+
+## License
+
+MIT

computer_control_mcp-0.1.0/README.md

@@ -0,0 +1,126 @@
+# Computer Control MCP
+
+A Python package that provides computer control capabilities using PyAutoGUI through a Model Context Protocol (MCP) server.
+
+## Project Structure
+
+```
+computer-control-mcp/
+├── docs/                  # Documentation
+│   ├── index.md          # Main documentation
+│   └── api.md            # API reference
+├── src/                  # Source code
+│   └── computer_control_mcp/  # Main package
+│       ├── __init__.py   # Package initialization
+│       ├── __main__.py   # Entry point for running as a module
+│       ├── core.py       # Core functionality
+│       ├── cli.py        # Command-line interface
+│       └── gui.py        # GUI for testing
+├── tests/                # Test files
+│   ├── conftest.py       # Pytest configuration
+│   └── test_computer_control.py  # Tests for core functionality
+├── LICENSE               # MIT license
+├── MANIFEST.in           # Package manifest
+├── pyproject.toml        # Project configuration
+└── README.md            # This file
+```
+
+## Installation
+
+```bash
+pip install computer-control-mcp
+```
+
+Or with uv:
+
+```bash
+uv pip install computer-control-mcp
+```
+
+## Features
+
+- Control mouse movements and clicks
+- Type text at the current cursor position
+- Take screenshots of the entire screen or specific windows
+- List and activate windows
+- Press keyboard keys
+- Drag and drop operations
+
+## Usage
+
+### Basic Example
+
+```python
+from computer_control_mcp.core import mcp
+
+# Click at specific coordinates
+mcp.click_screen(x=100, y=100)
+
+# Type text
+mcp.type_text(text="Hello, world!")
+
+# Take a screenshot
+screenshot = mcp.take_screenshot(mode="whole_screen")
+```
+
+### Command-line Interface
+
+```bash
+# Run the MCP server
+computer-control-mcp server
+
+# Click at coordinates
+computer-control-mcp click 100 100
+
+# Type text
+computer-control-mcp type "Hello, world!"
+
+# Take a screenshot
+computer-control-mcp screenshot --mode whole_screen
+
+# List all windows
+computer-control-mcp list-windows
+
+# Launch the GUI test harness
+computer-control-mcp gui
+```
+
+### Running as a Module
+
+You can run the package as a module:
+
+```bash
+python -m computer_control_mcp
+```
+
+## Development
+
+### Setting up the Development Environment
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/computer-control-mcp.git
+cd computer-control-mcp
+
+# Create a virtual environment and install dependencies
+python -m venv .venv
+.venv\Scripts\activate  # On Windows
+source .venv/bin/activate  # On Unix/macOS
+
+# Install in development mode
+pip install -e .
+```
+
+### Running Tests
+
+```bash
+python -m pytest
+```
+
+## API Reference
+
+See the [API Reference](docs/api.md) for detailed information about the available functions and classes.
+
+## License
+
+MIT

computer_control_mcp-0.1.0/computer_control_mcp/__init__.py

@@ -0,0 +1,11 @@
+"""
+Computer Control MCP - Python package for computer control via MCP.
+
+This package provides computer control capabilities using PyAutoGUI through a
+Model Context Protocol (MCP) server.
+"""
+
+from computer_control_mcp.core import mcp, main
+
+__version__ = "0.1.0"
+__all__ = ["mcp", "main"]

computer_control_mcp-0.1.0/computer_control_mcp/__main__.py

@@ -0,0 +1,30 @@
+"""
+Entry point for running the Computer Control MCP as a module.
+
+This module serves as the main entry point for the package.
+When executed directly (e.g., with `python -m computer_control_mcp`),
+it will run the MCP server.
+
+When used with `uvx computer-control-mcp`, it will also run the server.
+
+For CLI functionality, use:
+    computer-control-mcp <command>
+    uvx computer-control-mcp <command>
+"""
+
+import sys
+from computer_control_mcp.core import main as run_server
+from computer_control_mcp.cli import main as run_cli
+
+def main():
+    """Main entry point for the package."""
+    # If no arguments are provided, run the server
+    if len(sys.argv) == 1:
+        print("Starting Computer Control MCP server...")
+        run_server()
+    # Otherwise, pass the arguments to the CLI
+    else:
+        run_cli()
+
+if __name__ == "__main__":
+    main()

computer_control_mcp-0.1.0/computer_control_mcp/cli.py

@@ -0,0 +1,114 @@
+"""
+Command-line interface for Computer Control MCP.
+
+This module provides a command-line interface for interacting with the Computer Control MCP.
+"""
+
+import argparse
+import sys
+from computer_control_mcp.core import mcp, main as run_server
+
+def parse_args():
+    """Parse command-line arguments."""
+    parser = argparse.ArgumentParser(description="Computer Control MCP CLI")
+
+    subparsers = parser.add_subparsers(dest="command", help="Command to run")
+
+    # Server command
+    server_parser = subparsers.add_parser("server", help="Run the MCP server")
+
+    # Click command
+    click_parser = subparsers.add_parser("click", help="Click at specified coordinates")
+    click_parser.add_argument("x", type=int, help="X coordinate")
+    click_parser.add_argument("y", type=int, help="Y coordinate")
+
+    # Type text command
+    type_parser = subparsers.add_parser("type", help="Type text at current cursor position")
+    type_parser.add_argument("text", help="Text to type")
+
+    # Screenshot command
+    screenshot_parser = subparsers.add_parser("screenshot", help="Take a screenshot")
+    screenshot_parser.add_argument("--mode", choices=["all_windows", "single_window", "whole_screen"],
+                                  default="whole_screen", help="Screenshot mode")
+    screenshot_parser.add_argument("--title", help="Window title pattern (for single_window mode)")
+    screenshot_parser.add_argument("--regex", action="store_true", help="Use regex for title matching")
+    screenshot_parser.add_argument("--output", help="Output file path")
+
+    # List windows command
+    subparsers.add_parser("list-windows", help="List all open windows")
+
+    # GUI command
+    subparsers.add_parser("gui", help="Launch the GUI test harness")
+
+    return parser.parse_args()
+
+def main():
+    """Main entry point for the CLI."""
+    args = parse_args()
+
+    if args.command == "server":
+        run_server()
+
+    elif args.command == "click":
+        # Call the tool using the call_tool method
+        import asyncio
+        result = asyncio.run(mcp.call_tool("click_screen", {"x": args.x, "y": args.y}))
+        print(result)
+
+    elif args.command == "type":
+        # Call the tool using the call_tool method
+        import asyncio
+        result = asyncio.run(mcp.call_tool("type_text", {"text": args.text}))
+        print(result)
+
+    elif args.command == "screenshot":
+        if args.mode == "single_window" and not args.title:
+            print("Error: --title is required for single_window mode")
+            sys.exit(1)
+
+        # Call the tool using the call_tool method
+        import asyncio
+        result = asyncio.run(mcp.call_tool("take_screenshot", {
+            "mode": args.mode,
+            "title_pattern": args.title,
+            "use_regex": args.regex
+        }))
+
+        if args.output:
+            # Save the screenshot to a file
+            with open(args.output, "wb") as f:
+                f.write(result.image.data)
+            print(f"Screenshot saved to {args.output}")
+        else:
+            print("Screenshot taken successfully")
+
+    elif args.command == "list-windows":
+        # Call the tool using the call_tool method
+        import asyncio
+        result = asyncio.run(mcp.call_tool("list_windows", {}))
+
+        # Parse the result
+        windows = []
+        for item in result:
+            if hasattr(item, 'text'):
+                try:
+                    import json
+                    window_info = json.loads(item.text)
+                    windows.append(window_info)
+                except json.JSONDecodeError:
+                    print(f"Failed to parse window info: {item.text}")
+
+        # Display the windows
+        for i, window in enumerate(windows):
+            print(f"{i+1}. {window.get('title')} ({window.get('width')}x{window.get('height')})")
+
+    elif args.command == "gui":
+        from computer_control_mcp.gui import main as run_gui
+        run_gui()
+
+    else:
+        print("Error: No command specified")
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()