-
Notifications
You must be signed in to change notification settings - Fork 4
Expand file tree
/
Copy pathmanifest.json
More file actions
89 lines (89 loc) · 3.76 KB
/
manifest.json
File metadata and controls
89 lines (89 loc) · 3.76 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
{
"manifest_version": "0.2",
"name": "MacOS-MCP",
"version": "0.2.3",
"description": "Lightweight MCP Server for macOS desktop interaction",
"long_description": "MacOS-MCP is a lightweight, open-source MCP server that bridges AI agents with the macOS operating system. It enables LLM agents to perform real-world tasks such as app launching, window management, UI interaction, browser automation, desktop state capture, and shell execution using native macOS accessibility and automation APIs.\n\n**KEY FEATURES**\n- **Native macOS Integration**: Interact with applications, windows, and UI elements through the macOS Accessibility API and Quartz event system.\n- **Bring Your Own LLM/VLM**: Works with any language model and optionally provides visual snapshots when needed.\n- **Rich Toolset for Desktop Automation**: Pre-built tools for application control, mouse and keyboard input, scrolling, shell commands, and desktop state capture.\n- **Lightweight and Open Source**: Minimal setup with a focused Python package and MIT license.\n\n**MINIMUM REQUIREMENTS**\n- Python 3.11 or higher\n- macOS 12 or higher\n- Accessibility permissions granted to the terminal or application running the MCP server\n- UV Package Manager\nThis MCP server uses UV for running the package in a managed Python environment.\nInstallation:\n`curl -LsSf https://astral.sh/uv/install.sh | sh`\nFor detailed installation instructions, [see the UV documentation](https://docs.astral.sh/uv/)",
"author": {
"name": "CursorTouch",
"url": "https://github.com/CursorTouch/MacOS-MCP"
},
"homepage": "https://github.com/CursorTouch/MacOS-MCP",
"documentation": "https://github.com/CursorTouch/MacOS-MCP",
"icon": "assets/logo.png",
"server": {
"type": "python",
"entry_point": "./src/macos_mcp/__main__.py",
"mcp_config": {
"command": "uv",
"args": [
"--directory",
"${__dirname}",
"run",
"macos-mcp"
]
}
},
"tools": [
{
"name": "App",
"description": "Manage macOS applications by launching, switching focus, or resizing and moving the active window."
},
{
"name": "Shell",
"description": "Execute shell commands or AppleScript on macOS for system operations and automation."
},
{
"name": "Snapshot",
"description": "Capture desktop state including the focused window, open applications, interactive elements, scrollable regions, and an optional annotated screenshot."
},
{
"name": "Click",
"description": "Perform hover, single-click, or double-click actions at a screen coordinate using left, right, or middle mouse buttons."
},
{
"name": "Type",
"description": "Type text at a screen coordinate, optionally clearing existing content and pressing Enter after input."
},
{
"name": "Scroll",
"description": "Scroll vertically or horizontally at a coordinate or the current mouse position."
},
{
"name": "Move",
"description": "Move the mouse pointer to a coordinate or drag from the current position to a target coordinate."
},
{
"name": "Shortcut",
"description": "Execute macOS keyboard shortcuts such as command+c, command+v, command+tab, or command+space."
},
{
"name": "Wait",
"description": "Pause execution for a specified number of seconds."
},
{
"name": "Scrape",
"description": "Fetch the contents of a URL and return the response body as text."
}
],
"compatibility": {
"platforms": [
"darwin"
],
"runtimes": {
"python": ">=3.11"
}
},
"keywords": [
"macos",
"desktop",
"automation",
"ai",
"mcp"
],
"license": "MIT",
"repository": {
"type": "git",
"url": "https://github.com/CursorTouch/MacOS-MCP"
}
}