@runtime-inspector/client-mcp 0.1.0-alpha.1 → 0.1.0-alpha.2
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.
- package/README.md +44 -0
- package/package.json +3 -3
package/README.md
ADDED
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# @runtime-inspector/client-mcp
|
|
2
|
+
|
|
3
|
+
An [MCP](https://modelcontextprotocol.io/) server that lets a compatible AI client read and tune controls exposed by a running [Runtime Inspector](https://github.com/AmatoGiulio/runtime-inspector) app.
|
|
4
|
+
|
|
5
|
+
## Install and run
|
|
6
|
+
|
|
7
|
+
Start `npx runtime-inspector dev` from the app root (after installing the CLI and SDK as described in [Getting started](https://github.com/AmatoGiulio/runtime-inspector/blob/main/docs/getting-started.md)). Then configure your MCP client to launch:
|
|
8
|
+
|
|
9
|
+
~~~bash
|
|
10
|
+
npx -y @runtime-inspector/client-mcp@alpha
|
|
11
|
+
~~~
|
|
12
|
+
|
|
13
|
+
For clients that use a JSON `mcpServers` map, an example entry is:
|
|
14
|
+
|
|
15
|
+
~~~json
|
|
16
|
+
{
|
|
17
|
+
"mcpServers": {
|
|
18
|
+
"runtime-inspector": {
|
|
19
|
+
"command": "npx",
|
|
20
|
+
"args": ["-y", "@runtime-inspector/client-mcp@alpha"]
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
~~~
|
|
25
|
+
|
|
26
|
+
Your MCP client's actual configuration format may differ. On startup the server uses the CLI session file at `~/.runtime-inspector/session.json` to locate the broker. Explicit `RI_BROKER_URL` and `RI_TOKEN` environment variables override automatic discovery.
|
|
27
|
+
|
|
28
|
+
## Available tools
|
|
29
|
+
|
|
30
|
+
- `get_schema` — inspect exposed controls and current values.
|
|
31
|
+
- `set_control_value` — update one control.
|
|
32
|
+
- `batch_set` — validate and apply multiple values.
|
|
33
|
+
- `trigger` — run an exposed action.
|
|
34
|
+
- `list_scenes` and `open_scene` — inspect and replay available motion scenes.
|
|
35
|
+
|
|
36
|
+
Use `get_schema` before editing values. This client tunes the running app; **Apply to code** is handled by the web panel, not by an MCP tool.
|
|
37
|
+
|
|
38
|
+
Only connect trusted MCP clients to your local development broker. Session tokens grant control of the running app.
|
|
39
|
+
|
|
40
|
+
## Links
|
|
41
|
+
|
|
42
|
+
[Repository](https://github.com/AmatoGiulio/runtime-inspector) · [Getting started](https://github.com/AmatoGiulio/runtime-inspector/blob/main/docs/getting-started.md) · [Issues](https://github.com/AmatoGiulio/runtime-inspector/issues)
|
|
43
|
+
|
|
44
|
+
**Status:** alpha, APIs may change. MIT license.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@runtime-inspector/client-mcp",
|
|
3
|
-
"version": "0.1.0-alpha.
|
|
3
|
+
"version": "0.1.0-alpha.2",
|
|
4
4
|
"description": "MCP server that lets an AI agent tune a running app through the Runtime Inspector broker.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -30,13 +30,13 @@
|
|
|
30
30
|
"@modelcontextprotocol/sdk": "^1.32.1",
|
|
31
31
|
"ws": "^8.18.0",
|
|
32
32
|
"zod": "^3.24.1",
|
|
33
|
-
"@runtime-inspector/protocol": "0.1.0-alpha.
|
|
33
|
+
"@runtime-inspector/protocol": "0.1.0-alpha.2"
|
|
34
34
|
},
|
|
35
35
|
"devDependencies": {
|
|
36
36
|
"@types/ws": "^8.5.13",
|
|
37
37
|
"tsup": "^8.3.5",
|
|
38
38
|
"vitest": "^4.1.9",
|
|
39
|
-
"@runtime-inspector/transport-ws": "0.1.0-alpha.
|
|
39
|
+
"@runtime-inspector/transport-ws": "0.1.0-alpha.2"
|
|
40
40
|
},
|
|
41
41
|
"scripts": {
|
|
42
42
|
"build": "tsup src/index.ts --format esm --dts",
|