You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+11-29Lines changed: 11 additions & 29 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,39 +1,29 @@
1
-
# AdaMCP
1
+
# AdaMCP - MCP Server for AdaEngine
2
2
3
3
`AdaMCP` exposes a live AdaEngine application as an MCP server. It is built for inspection-first workflows: world/entity/resource introspection, render capture, and AdaUI tree inspection with a small set of safe UI actions.
4
4
5
-
## Modules
6
-
7
-
-`AdaMCPCore`: runtime surface, type introspection, AdaUI inspection, and tool/resource payloads.
8
-
-`AdaMCPServer`: MCP server bootstrapping plus HTTP and stdio transports.
9
-
-`AdaMCPPlugin`: AdaEngine plugin for embedding `AdaMCP` directly into an app.
10
-
11
-
## Current platform support
12
-
13
-
`AdaMCP` currently ships for Apple platforms used by AdaEngine hosts today: `macOS 15+`, `iOS 18+`, `tvOS 18+`, and `visionOS 2+`.
5
+
## Current platform support
14
6
15
7
The important distinction is:
16
8
17
9
- MCP clients can live anywhere and connect over HTTP or stdio.
18
10
- The host runtime now builds on the broader Apple surface, while `stdio` remains primarily a local host transport and HTTP is the main cross-device option.
19
11
20
-
So `SloppyClient` no longer needs a `macOS`-only gate just to embed the MCP plugin.
21
-
22
-
## What you get
12
+
## What you get 🌸
23
13
24
-
- World, entity, component, resource, and asset inspection.
25
-
- Screenshot capture for live render output.
26
-
- AdaUI inspection tools such as `ui.list_windows`, `ui.get_tree`, `ui.get_node`, `ui.find_nodes`, and `ui.hit_test`.
27
-
- AdaUI diagnostics and safe actions such as focus traversal, deterministic tap, and scroll-to-node.
28
-
- MCP resources under `ada://...`, including `ada://ui/windows`, `ada://ui/window/{id}`, `ada://ui/tree/{id}`, and `ada://ui/node/{windowId}/{nodeRef}`.
14
+
-😳 World, entity, component, resource, and asset inspection.
15
+
-📸 Screenshot capture for live render output.
16
+
-💉 AdaUI inspection tools such as `ui.list_windows`, `ui.get_tree`, `ui.get_node`, `ui.find_nodes`, and `ui.hit_test`.
17
+
-🧑🏫 AdaUI diagnostics and safe actions such as focus traversal, deterministic tap, and scroll-to-node.
18
+
-📦 MCP resources under `ada://...`, including `ada://ui/windows`, `ada://ui/window/{id}`, `ada://ui/tree/{id}`, and `ada://ui/node/{windowId}/{nodeRef}`.
29
19
30
-
## Embedding in an AdaEngine app
20
+
## Embedding in an AdaEngine app ⚒️
31
21
32
22
Until the package is published, add it as a local SwiftPM dependency:
0 commit comments