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,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.
|