computer-control-mcp 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,151 @@
1
+ Metadata-Version: 2.4
2
+ Name: computer-control-mcp
3
+ Version: 0.1.0
4
+ Summary: Computer control capabilities using PyAutoGUI through a Model Context Protocol (MCP) server
5
+ Project-URL: Homepage, https://github.com/AB498/computer-control-mcp
6
+ Project-URL: Issues, https://github.com/AB498/computer-control-mcp/issues
7
+ Project-URL: Documentation, https://github.com/AB498/computer-control-mcp#readme
8
+ Author-email: Computer Control MCP Authors <example@example.com>
9
+ License: MIT
10
+ License-File: LICENSE
11
+ Classifier: Development Status :: 4 - Beta
12
+ Classifier: Intended Audience :: Developers
13
+ Classifier: License :: OSI Approved :: MIT License
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Programming Language :: Python :: 3.12
16
+ Classifier: Topic :: Software Development :: Libraries
17
+ Classifier: Topic :: Utilities
18
+ Requires-Python: >=3.12
19
+ Requires-Dist: mcp[cli]
20
+ Requires-Dist: pillow
21
+ Requires-Dist: pyautogui
22
+ Requires-Dist: pygetwindow
23
+ Requires-Dist: watchdog
24
+ Description-Content-Type: text/markdown
25
+
26
+ # Computer Control MCP
27
+
28
+ A Python package that provides computer control capabilities using PyAutoGUI through a Model Context Protocol (MCP) server.
29
+
30
+ ## Project Structure
31
+
32
+ ```
33
+ computer-control-mcp/
34
+ ├── docs/ # Documentation
35
+ │ ├── index.md # Main documentation
36
+ │ └── api.md # API reference
37
+ ├── src/ # Source code
38
+ │ └── computer_control_mcp/ # Main package
39
+ │ ├── __init__.py # Package initialization
40
+ │ ├── __main__.py # Entry point for running as a module
41
+ │ ├── core.py # Core functionality
42
+ │ ├── cli.py # Command-line interface
43
+ │ └── gui.py # GUI for testing
44
+ ├── tests/ # Test files
45
+ │ ├── conftest.py # Pytest configuration
46
+ │ └── test_computer_control.py # Tests for core functionality
47
+ ├── LICENSE # MIT license
48
+ ├── MANIFEST.in # Package manifest
49
+ ├── pyproject.toml # Project configuration
50
+ └── README.md # This file
51
+ ```
52
+
53
+ ## Installation
54
+
55
+ ```bash
56
+ pip install computer-control-mcp
57
+ ```
58
+
59
+ Or with uv:
60
+
61
+ ```bash
62
+ uv pip install computer-control-mcp
63
+ ```
64
+
65
+ ## Features
66
+
67
+ - Control mouse movements and clicks
68
+ - Type text at the current cursor position
69
+ - Take screenshots of the entire screen or specific windows
70
+ - List and activate windows
71
+ - Press keyboard keys
72
+ - Drag and drop operations
73
+
74
+ ## Usage
75
+
76
+ ### Basic Example
77
+
78
+ ```python
79
+ from computer_control_mcp.core import mcp
80
+
81
+ # Click at specific coordinates
82
+ mcp.click_screen(x=100, y=100)
83
+
84
+ # Type text
85
+ mcp.type_text(text="Hello, world!")
86
+
87
+ # Take a screenshot
88
+ screenshot = mcp.take_screenshot(mode="whole_screen")
89
+ ```
90
+
91
+ ### Command-line Interface
92
+
93
+ ```bash
94
+ # Run the MCP server
95
+ computer-control-mcp server
96
+
97
+ # Click at coordinates
98
+ computer-control-mcp click 100 100
99
+
100
+ # Type text
101
+ computer-control-mcp type "Hello, world!"
102
+
103
+ # Take a screenshot
104
+ computer-control-mcp screenshot --mode whole_screen
105
+
106
+ # List all windows
107
+ computer-control-mcp list-windows
108
+
109
+ # Launch the GUI test harness
110
+ computer-control-mcp gui
111
+ ```
112
+
113
+ ### Running as a Module
114
+
115
+ You can run the package as a module:
116
+
117
+ ```bash
118
+ python -m computer_control_mcp
119
+ ```
120
+
121
+ ## Development
122
+
123
+ ### Setting up the Development Environment
124
+
125
+ ```bash
126
+ # Clone the repository
127
+ git clone https://github.com/yourusername/computer-control-mcp.git
128
+ cd computer-control-mcp
129
+
130
+ # Create a virtual environment and install dependencies
131
+ python -m venv .venv
132
+ .venv\Scripts\activate # On Windows
133
+ source .venv/bin/activate # On Unix/macOS
134
+
135
+ # Install in development mode
136
+ pip install -e .
137
+ ```
138
+
139
+ ### Running Tests
140
+
141
+ ```bash
142
+ python -m pytest
143
+ ```
144
+
145
+ ## API Reference
146
+
147
+ See the [API Reference](docs/api.md) for detailed information about the available functions and classes.
148
+
149
+ ## License
150
+
151
+ MIT
@@ -0,0 +1,5 @@
1
+ computer_control_mcp-0.1.0.dist-info/METADATA,sha256=JBbB9AVbTm0RaaSU_AcnB9wkEYc0bYOgyoUS_5pjjUc,3829
2
+ computer_control_mcp-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
3
+ computer_control_mcp-0.1.0.dist-info/entry_points.txt,sha256=Dgm6i7GIfGM58GUeRm57HySZjhcJpCua_UI04H8DOTo,76
4
+ computer_control_mcp-0.1.0.dist-info/licenses/LICENSE,sha256=0C_o70kEdEUMg_e1lh9RgS8bqNTHZgmicrRP9DcY4pw,1085
5
+ computer_control_mcp-0.1.0.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: hatchling 1.27.0
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ computer-control-mcp = computer_control_mcp.__main__:main
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2023 Computer Control MCP Authors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.