streonor-mcp 0.8.2__tar.gz

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.
Files changed (46) hide show
  1. streonor_mcp-0.8.2/CHANGELOG.md +83 -0
  2. streonor_mcp-0.8.2/CONTRIBUTING.md +13 -0
  3. streonor_mcp-0.8.2/LICENSE +21 -0
  4. streonor_mcp-0.8.2/MANIFEST.in +2 -0
  5. streonor_mcp-0.8.2/PKG-INFO +121 -0
  6. streonor_mcp-0.8.2/README.md +104 -0
  7. streonor_mcp-0.8.2/SECURITY.md +20 -0
  8. streonor_mcp-0.8.2/docs/capabilities.md +42 -0
  9. streonor_mcp-0.8.2/docs/examples.md +99 -0
  10. streonor_mcp-0.8.2/docs/images/s6-boot-artwork.png +0 -0
  11. streonor_mcp-0.8.2/docs/images/shortcut-icons.png +0 -0
  12. streonor_mcp-0.8.2/docs/reference.md +208 -0
  13. streonor_mcp-0.8.2/docs/testing.md +50 -0
  14. streonor_mcp-0.8.2/pyproject.toml +26 -0
  15. streonor_mcp-0.8.2/setup.cfg +4 -0
  16. streonor_mcp-0.8.2/streonor_mcp/__init__.py +1 -0
  17. streonor_mcp-0.8.2/streonor_mcp/app.py +76 -0
  18. streonor_mcp-0.8.2/streonor_mcp/catalog.py +67 -0
  19. streonor_mcp-0.8.2/streonor_mcp/devices.py +40 -0
  20. streonor_mcp-0.8.2/streonor_mcp/flows.py +56 -0
  21. streonor_mcp-0.8.2/streonor_mcp/hotkeys.py +53 -0
  22. streonor_mcp-0.8.2/streonor_mcp/icons.py +87 -0
  23. streonor_mcp-0.8.2/streonor_mcp/layout.py +136 -0
  24. streonor_mcp-0.8.2/streonor_mcp/live.py +187 -0
  25. streonor_mcp-0.8.2/streonor_mcp/live_ui.py +263 -0
  26. streonor_mcp-0.8.2/streonor_mcp/locking.py +61 -0
  27. streonor_mcp-0.8.2/streonor_mcp/paths.py +33 -0
  28. streonor_mcp-0.8.2/streonor_mcp/profiles.py +541 -0
  29. streonor_mcp-0.8.2/streonor_mcp/scenes.py +184 -0
  30. streonor_mcp-0.8.2/streonor_mcp/server.py +263 -0
  31. streonor_mcp-0.8.2/streonor_mcp/svg.py +37 -0
  32. streonor_mcp-0.8.2/streonor_mcp.egg-info/PKG-INFO +121 -0
  33. streonor_mcp-0.8.2/streonor_mcp.egg-info/SOURCES.txt +44 -0
  34. streonor_mcp-0.8.2/streonor_mcp.egg-info/dependency_links.txt +1 -0
  35. streonor_mcp-0.8.2/streonor_mcp.egg-info/entry_points.txt +2 -0
  36. streonor_mcp-0.8.2/streonor_mcp.egg-info/requires.txt +8 -0
  37. streonor_mcp-0.8.2/streonor_mcp.egg-info/top_level.txt +1 -0
  38. streonor_mcp-0.8.2/tests/test_app.py +48 -0
  39. streonor_mcp-0.8.2/tests/test_flows.py +23 -0
  40. streonor_mcp-0.8.2/tests/test_hotkeys.py +42 -0
  41. streonor_mcp-0.8.2/tests/test_icons.py +70 -0
  42. streonor_mcp-0.8.2/tests/test_live.py +63 -0
  43. streonor_mcp-0.8.2/tests/test_mcp.py +221 -0
  44. streonor_mcp-0.8.2/tests/test_platforms.py +35 -0
  45. streonor_mcp-0.8.2/tests/test_profiles.py +156 -0
  46. streonor_mcp-0.8.2/tests/test_safety.py +94 -0
@@ -0,0 +1,83 @@
1
+ # Changelog
2
+
3
+ ## 0.8.2
4
+
5
+ - Add package metadata for the official MCP Registry and prepare PyPI distribution.
6
+ - Update the setup guide for the public repository.
7
+
8
+ ## 0.8.1
9
+
10
+ - Fix scene archive validation on macOS when the temporary directory resolves to a different path.
11
+ - Limit the experimental Windows installer to copying the executable. Use the standard stdio setup for normal installs.
12
+ - Ignore local credentials and personal device exports. Clarify device compatibility and live editing limits.
13
+
14
+ ## 0.8.0
15
+
16
+ - Replace an occupied control by action name in one write. Apply preferred images for several states together and reuse prepared actions and icons on apply.
17
+ - Opt in to fast managed restarts on Windows with `STREONOR_FAST_RESTART=1`.
18
+
19
+ - Set or reset the selected S6 Mini scene’s keypad and Scene Shift icons, including the selected Hotkey Switch state, in place through the running Windows app. The scene ID and name are preserved.
20
+
21
+ - Import an edited scene copy with its pages and icons while STREONOR stays open on Windows.
22
+ - Preview a full layout and import edits across multiple pages in one step. Create, replace, configure, or remove controls and choose which pages to rebuild. Include Action Flows and target individual icon states.
23
+
24
+ ## 0.7.1
25
+
26
+ - Create a native Hotkey Switch with the same shortcut in both states.
27
+ - Preview and set icons for individual action states.
28
+ - Verify shortcut configuration in the vendor app before relying on its behavior.
29
+
30
+ ## 0.7.0
31
+
32
+ - Preview and reorder existing pages while preserving the current selection.
33
+ - Preview and restore controls from a backup scoped to the original scene and page.
34
+ - Prepare boot artwork with a choice of crop or black padding for the Devices menu.
35
+ - Route Create Folder to the native app so generic action creation cannot leave a broken folder button.
36
+ - Add readable titles for all 20 MCP tools and direct creation of single-key hotkey shortcuts.
37
+ - Keep valid Toolbox actions discoverable when installed plugin manifests contain malformed entries.
38
+ - Refresh the README, device-photo links, contributor links, and tool reference. Add a gallery of MCP output.
39
+ - License the independent project under MIT.
40
+ - Add issue templates for bugs and device support.
41
+
42
+ ## 0.6.0
43
+
44
+ - Default icons for new actions and flows, plus destination changes.
45
+ - Local icon resolution with a generated label fallback and safe SVG support.
46
+ - Name-based installed Toolbox slots with explicit runtime configuration limits.
47
+ - Native multi-step hotkey chords with separate modifiers and delays.
48
+ - Everyday create, read, update and delete examples.
49
+
50
+ ## 0.5.0
51
+
52
+ - Scene rename/delete with catalog checks and full-folder archival.
53
+ - Create scenes from selected existing buttons, knobs and flows. copy PNG assets.
54
+ - Optional solid icon backgrounds and connected edge-background replacement.
55
+ - Simple README with official device-photo links and support table. task-based examples.
56
+ - Protocol coverage for all 15 tools and scene/flow CRUD.
57
+
58
+ ## 0.4.0
59
+
60
+ - Native ordered Multi Action flows built from same-page action templates.
61
+ - Blank scene preview and creation with vendor catalog registration and backup.
62
+ - Protocol coverage for all 13 tools, scene creation, duplicate rejection and ordered flows.
63
+
64
+ ## 0.3.0
65
+
66
+ - Release-pinned uvx setup for Claude, Codex and JSON clients.
67
+ - Cross-process edit locks and preflight validation before closing the vendor app.
68
+ - Bounded input reads, image pixel limits and strict JSON numbers.
69
+ - Atomic, non-overwriting image output. uncommitted icon cleanup.
70
+ - Fail-closed token validation and duplicate Authorization header rejection.
71
+ - Protocol tests covering all tools plus HTTP and concurrent-editor regression tests.
72
+
73
+ ## 0.2.0
74
+
75
+ - Standard Python package and `streonor-mcp` command for local stdio clients.
76
+ - Portable profile/image operations, configurable paths, Unix process checks.
77
+ - MCP tool risk annotations and server instructions.
78
+ - Windows opt-in app close/reopen around guarded edits.
79
+ - 1254 x 1254 PNG icon normalization and standalone icon preparation.
80
+ - Claude and Codex setup examples, contribution guidance and three-platform CI.
81
+
82
+ Hardware validation remains limited to the S6 Mini on Windows. Native macOS/Linux vendor
83
+ app integration and direct USB control are not verified.
@@ -0,0 +1,13 @@
1
+ # Contributing
2
+
3
+ Install Python 3.12+, create a virtual environment, then run `python -m pip install -e .`.
4
+ Run `python -m unittest discover -s tests` and `git diff --check` before submitting a change.
5
+ CI covers Windows, macOS and Linux. simulated tests do not establish hardware compatibility.
6
+
7
+ Add devices in `streonor_mcp/devices.py`. Only mark a device supported after documenting observed results.
8
+ Keep shared profile and image operations independent of device models. Platform paths belong in
9
+ `paths.py`. app lifecycle code belongs in `app.py`. Do not add undocumented USB write commands.
10
+
11
+ Include a regression test for safety checks or nontrivial behavior. Describe what was tested on
12
+ real hardware and what was simulated. Never submit personal profiles, tokens, app logs or captures
13
+ containing private data. Keep pull requests focused and preserve existing user configurations.
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Lucas De Mederios
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.
@@ -0,0 +1,2 @@
1
+ include CHANGELOG.md CONTRIBUTING.md SECURITY.md
2
+ recursive-include docs *.md *.png
@@ -0,0 +1,121 @@
1
+ Metadata-Version: 2.4
2
+ Name: streonor-mcp
3
+ Version: 0.8.2
4
+ Summary: Community MCP tools for STREONOR profiles, actions and icons
5
+ License-Expression: MIT
6
+ Project-URL: Repository, https://github.com/lde-medeiros/streonor-mcp
7
+ Project-URL: Issues, https://github.com/lde-medeiros/streonor-mcp/issues
8
+ Requires-Python: >=3.12
9
+ Description-Content-Type: text/markdown
10
+ License-File: LICENSE
11
+ Requires-Dist: mcp<2,>=1.9
12
+ Requires-Dist: Pillow<14,>=11
13
+ Requires-Dist: resvg-py<0.6,>=0.5
14
+ Provides-Extra: live
15
+ Requires-Dist: pywinauto<0.7,>=0.6.9; sys_platform == "win32" and extra == "live"
16
+ Dynamic: license-file
17
+
18
+ # STREONOR MCP
19
+
20
+ <!-- mcp-name: io.github.lde-medeiros/streonor-mcp -->
21
+
22
+ Set up your STREONOR stream controller from Claude or Codex. Build scenes, assign shortcuts, and choose icons by describing what you want.
23
+
24
+ > “Make a Work scene with buttons for email, calendar, and GitHub. Copy the volume knob from Daily.”
25
+
26
+ [Get started](#get-started) · [Devices](#devices) · [Examples](docs/examples.md) · [Changelog](CHANGELOG.md)
27
+
28
+ An independent community project. Unaffiliated with STREONOR.
29
+
30
+ ## Get started
31
+
32
+ 1. Install the STREONOR app on Windows, connect your STREONOR device, and make sure you have [uv](https://docs.astral.sh/uv/getting-started/installation/) and Git.
33
+ 2. Run the command for your client.
34
+
35
+ **Codex**
36
+
37
+ ```sh
38
+ codex mcp add streonor -- uvx --python 3.12 --from git+https://github.com/lde-medeiros/streonor-mcp@v0.8.2 streonor-mcp
39
+ ```
40
+
41
+ **Claude Code**
42
+
43
+ ```sh
44
+ claude mcp add --transport stdio --scope user streonor -- uvx --python 3.12 --from git+https://github.com/lde-medeiros/streonor-mcp@v0.8.2 streonor-mcp
45
+ ```
46
+
47
+ 3. Restart your client and ask: “Use STREONOR MCP to list my scenes.”
48
+
49
+ [Claude Desktop and other clients](docs/reference.md#connect-claude-or-codex) · [macOS and Linux exported profiles](docs/reference.md#platform-support-and-paths)
50
+
51
+ ## What you can do
52
+
53
+ - **Build or edit a scene.** Fill a page with app launchers, shortcuts, knobs, or multi-step Action Flows. The MCP previews changes and keeps backups.
54
+ - **Give each state its own icon.** Use an installed icon or supply your own, including separate images for a Hotkey Switch.
55
+ - **Keep the Windows app open.** Try experimental live icon editing in the original S6 Mini scene or import a full layout as a scene copy. Other edits to the original scene use an app restart. [Live editing setup](docs/reference.md#edit-while-streonor-stays-open).
56
+
57
+ ## Devices
58
+
59
+ The S6 Mini is verified on Windows. Have a different model? Try the setup above and start by listing your scenes. [Share your model and results](CONTRIBUTING.md) to help us document device support.
60
+
61
+ | Product photo | Model | MCP support |
62
+ | --- | --- | --- |
63
+ | <img src="https://streonor.net/cdn/shop/files/S6_Mini_Black_White_Website_Main_V3.png?v=1784532906&amp;width=320" alt="STREONOR S6 Mini" width="128"> | **S6 Mini** | Supported and tested on Windows |
64
+ | <img src="https://streonor.net/cdn/shop/files/S10_Pro_Black_Website_Main_V2.png?v=1784533717&amp;width=320" alt="STREONOR S10 Pro" width="128"> | S10 Pro | [Contribute today](CONTRIBUTING.md) |
65
+ | <img src="https://streonor.net/cdn/shop/files/S15_1.jpg?v=1776650323&amp;width=320" alt="STREONOR S15 Standard" width="128"> | S15 Standard | [Contribute today](CONTRIBUTING.md) |
66
+ | <img src="https://streonor.net/cdn/shop/files/32_-2.jpg?v=1794382927&amp;width=320" alt="STREONOR S32 Max" width="128"> | S32 Max | [Contribute today](CONTRIBUTING.md) |
67
+
68
+ Product photos are served by the [STREONOR storefront](https://streonor.net/).
69
+
70
+ ## Available actions
71
+
72
+ The MCP creates actions from your installed Toolbox. Ask it to list the actions available on your computer. Some actions need extra plugin settings or connections. Configure Create Folder in the STREONOR app.
73
+
74
+ <details>
75
+ <summary>See the action types found on one installation</summary>
76
+
77
+ | Plugin | Action types |
78
+ | --- | --- |
79
+ | Brightness | Brightness, devsleep |
80
+ | Browser | Back, Collect, Forward, Refresh |
81
+ | Calendario | Calendario |
82
+ | close | Close |
83
+ | ETS2 Hotkey | Boosting Speed, Cruise Control, Double Flashing Light, Downshift, Flashing Headlights, Handbrake, Headlight, High Beam, Horns, Ignition/Shutdown, Left Turn Signal, Reduce Speed, Right Turn Signal, Upshift, Windshield Wiper |
84
+ | Go back | Go back |
85
+ | Hotkey | Hotkey |
86
+ | HotkeySwitch | HotkeySwitch |
87
+ | K1ProLEDLight | LED-, LED+, LEDMODECHANGE, LEDSPEED-, LEDSPEED+, WinqMac |
88
+ | KnobOperatingGroup | KnobOperatingGroup |
89
+ | Mouse event | Mouse event |
90
+ | Multi Action | Delay, Multi Action, Multi Action ActionTrigger, Multi Action ActionWheel, Multi Action LunBo, Multi Action Toggle |
91
+ | Multimedia | Multimedia, SystemVolume |
92
+ | musicalrhythm | 图谱1, 图谱2, 图谱3, 图谱4, 图谱5 |
93
+ | Network | UDP |
94
+ | OBS Studio | Audio Mixer, Record, Scene, Screenshot, Source Visibility, Stream, Studio Mode, Transition, Virtual camera, 绿幕背景图 DN, 绿幕背景图 UP |
95
+ | OBS Tool | Browser Source, CPU Usage, Dropped Frames, Filter Switch, Image Settings, Input Monitor Settings, Input Mute Toggle, Input Volume, Input Volume Control, Input Volume Settings, Instant Replay, Next Scene, Previous Scene, Remote Recording Start/Stop/Pause, Remote Streaming Start/Stop, Scene Switcher, Set Profile, Set Scene Collection, Set Transition, Source Animation, Source Visibility, Studio Mode Toggle, Video Playback, Virtual Camera |
96
+ | Open | Open, OpenApps |
97
+ | Pages | change page, Go to page, Next page, Page Indicator, Previous page |
98
+ | Password | Password |
99
+ | Quick Control | Calculator, Control panel, Display desktop, Emoticons, Home page, Increase the volume, Lower the volume, Mail, Microphone, Music, Mute, Notification, Search bar, Sleep, Speech recognition, Switch screen, Task Manager |
100
+ | Scene Shift | Scene Shift |
101
+ | Soundboard | Play Audio, Stop Audio |
102
+ | Super Hotkeys | Super Hotkeys |
103
+ | Text | Text |
104
+ | Time Options | Countdown, Timer, World Time |
105
+ | Touchbar | Decrease screen brightness, Desktop Saver, Dictation, Dispatch Center, DND Mode, Fast Forward, Fast Rewind, Focus On Search, Increase screen brightness, Input Method, Launchpad, Mute, Next Track, Notification Center, Play/Pause, Previous Track, Screen brightness, Screen Lock, Screenshot, Show Desktop, Siri, Sleep, Volume, Volume down, Volume up |
106
+ | Useful notes | Record to-do, Remember things |
107
+ | Visual Studio Code | Change Language, Create Terminal, Execute Command, Execute Terminal Command, Insert Snippet, Open Folder |
108
+ | vMix | Shortcut |
109
+ | Weather query | Weather query |
110
+ | Website | Website |
111
+ | YouTube | Chat Message, Viewers |
112
+
113
+ </details>
114
+
115
+ ## Learn more
116
+
117
+ [Example workflows](docs/examples.md) · [Tool reference](docs/reference.md) · [Capability coverage](docs/capabilities.md) · [Contribute](CONTRIBUTING.md)
118
+
119
+ ## License
120
+
121
+ The original Streonor MCP code and documentation are available under the [MIT License](LICENSE). STREONOR’s name identifies compatible products. The vendor software, trademarks, and linked material belong to their respective owners and are outside the scope of this license.
@@ -0,0 +1,104 @@
1
+ # STREONOR MCP
2
+
3
+ <!-- mcp-name: io.github.lde-medeiros/streonor-mcp -->
4
+
5
+ Set up your STREONOR stream controller from Claude or Codex. Build scenes, assign shortcuts, and choose icons by describing what you want.
6
+
7
+ > “Make a Work scene with buttons for email, calendar, and GitHub. Copy the volume knob from Daily.”
8
+
9
+ [Get started](#get-started) · [Devices](#devices) · [Examples](docs/examples.md) · [Changelog](CHANGELOG.md)
10
+
11
+ An independent community project. Unaffiliated with STREONOR.
12
+
13
+ ## Get started
14
+
15
+ 1. Install the STREONOR app on Windows, connect your STREONOR device, and make sure you have [uv](https://docs.astral.sh/uv/getting-started/installation/) and Git.
16
+ 2. Run the command for your client.
17
+
18
+ **Codex**
19
+
20
+ ```sh
21
+ codex mcp add streonor -- uvx --python 3.12 --from git+https://github.com/lde-medeiros/streonor-mcp@v0.8.2 streonor-mcp
22
+ ```
23
+
24
+ **Claude Code**
25
+
26
+ ```sh
27
+ claude mcp add --transport stdio --scope user streonor -- uvx --python 3.12 --from git+https://github.com/lde-medeiros/streonor-mcp@v0.8.2 streonor-mcp
28
+ ```
29
+
30
+ 3. Restart your client and ask: “Use STREONOR MCP to list my scenes.”
31
+
32
+ [Claude Desktop and other clients](docs/reference.md#connect-claude-or-codex) · [macOS and Linux exported profiles](docs/reference.md#platform-support-and-paths)
33
+
34
+ ## What you can do
35
+
36
+ - **Build or edit a scene.** Fill a page with app launchers, shortcuts, knobs, or multi-step Action Flows. The MCP previews changes and keeps backups.
37
+ - **Give each state its own icon.** Use an installed icon or supply your own, including separate images for a Hotkey Switch.
38
+ - **Keep the Windows app open.** Try experimental live icon editing in the original S6 Mini scene or import a full layout as a scene copy. Other edits to the original scene use an app restart. [Live editing setup](docs/reference.md#edit-while-streonor-stays-open).
39
+
40
+ ## Devices
41
+
42
+ The S6 Mini is verified on Windows. Have a different model? Try the setup above and start by listing your scenes. [Share your model and results](CONTRIBUTING.md) to help us document device support.
43
+
44
+ | Product photo | Model | MCP support |
45
+ | --- | --- | --- |
46
+ | <img src="https://streonor.net/cdn/shop/files/S6_Mini_Black_White_Website_Main_V3.png?v=1784532906&amp;width=320" alt="STREONOR S6 Mini" width="128"> | **S6 Mini** | Supported and tested on Windows |
47
+ | <img src="https://streonor.net/cdn/shop/files/S10_Pro_Black_Website_Main_V2.png?v=1784533717&amp;width=320" alt="STREONOR S10 Pro" width="128"> | S10 Pro | [Contribute today](CONTRIBUTING.md) |
48
+ | <img src="https://streonor.net/cdn/shop/files/S15_1.jpg?v=1776650323&amp;width=320" alt="STREONOR S15 Standard" width="128"> | S15 Standard | [Contribute today](CONTRIBUTING.md) |
49
+ | <img src="https://streonor.net/cdn/shop/files/32_-2.jpg?v=1794382927&amp;width=320" alt="STREONOR S32 Max" width="128"> | S32 Max | [Contribute today](CONTRIBUTING.md) |
50
+
51
+ Product photos are served by the [STREONOR storefront](https://streonor.net/).
52
+
53
+ ## Available actions
54
+
55
+ The MCP creates actions from your installed Toolbox. Ask it to list the actions available on your computer. Some actions need extra plugin settings or connections. Configure Create Folder in the STREONOR app.
56
+
57
+ <details>
58
+ <summary>See the action types found on one installation</summary>
59
+
60
+ | Plugin | Action types |
61
+ | --- | --- |
62
+ | Brightness | Brightness, devsleep |
63
+ | Browser | Back, Collect, Forward, Refresh |
64
+ | Calendario | Calendario |
65
+ | close | Close |
66
+ | ETS2 Hotkey | Boosting Speed, Cruise Control, Double Flashing Light, Downshift, Flashing Headlights, Handbrake, Headlight, High Beam, Horns, Ignition/Shutdown, Left Turn Signal, Reduce Speed, Right Turn Signal, Upshift, Windshield Wiper |
67
+ | Go back | Go back |
68
+ | Hotkey | Hotkey |
69
+ | HotkeySwitch | HotkeySwitch |
70
+ | K1ProLEDLight | LED-, LED+, LEDMODECHANGE, LEDSPEED-, LEDSPEED+, WinqMac |
71
+ | KnobOperatingGroup | KnobOperatingGroup |
72
+ | Mouse event | Mouse event |
73
+ | Multi Action | Delay, Multi Action, Multi Action ActionTrigger, Multi Action ActionWheel, Multi Action LunBo, Multi Action Toggle |
74
+ | Multimedia | Multimedia, SystemVolume |
75
+ | musicalrhythm | 图谱1, 图谱2, 图谱3, 图谱4, 图谱5 |
76
+ | Network | UDP |
77
+ | OBS Studio | Audio Mixer, Record, Scene, Screenshot, Source Visibility, Stream, Studio Mode, Transition, Virtual camera, 绿幕背景图 DN, 绿幕背景图 UP |
78
+ | OBS Tool | Browser Source, CPU Usage, Dropped Frames, Filter Switch, Image Settings, Input Monitor Settings, Input Mute Toggle, Input Volume, Input Volume Control, Input Volume Settings, Instant Replay, Next Scene, Previous Scene, Remote Recording Start/Stop/Pause, Remote Streaming Start/Stop, Scene Switcher, Set Profile, Set Scene Collection, Set Transition, Source Animation, Source Visibility, Studio Mode Toggle, Video Playback, Virtual Camera |
79
+ | Open | Open, OpenApps |
80
+ | Pages | change page, Go to page, Next page, Page Indicator, Previous page |
81
+ | Password | Password |
82
+ | Quick Control | Calculator, Control panel, Display desktop, Emoticons, Home page, Increase the volume, Lower the volume, Mail, Microphone, Music, Mute, Notification, Search bar, Sleep, Speech recognition, Switch screen, Task Manager |
83
+ | Scene Shift | Scene Shift |
84
+ | Soundboard | Play Audio, Stop Audio |
85
+ | Super Hotkeys | Super Hotkeys |
86
+ | Text | Text |
87
+ | Time Options | Countdown, Timer, World Time |
88
+ | Touchbar | Decrease screen brightness, Desktop Saver, Dictation, Dispatch Center, DND Mode, Fast Forward, Fast Rewind, Focus On Search, Increase screen brightness, Input Method, Launchpad, Mute, Next Track, Notification Center, Play/Pause, Previous Track, Screen brightness, Screen Lock, Screenshot, Show Desktop, Siri, Sleep, Volume, Volume down, Volume up |
89
+ | Useful notes | Record to-do, Remember things |
90
+ | Visual Studio Code | Change Language, Create Terminal, Execute Command, Execute Terminal Command, Insert Snippet, Open Folder |
91
+ | vMix | Shortcut |
92
+ | Weather query | Weather query |
93
+ | Website | Website |
94
+ | YouTube | Chat Message, Viewers |
95
+
96
+ </details>
97
+
98
+ ## Learn more
99
+
100
+ [Example workflows](docs/examples.md) · [Tool reference](docs/reference.md) · [Capability coverage](docs/capabilities.md) · [Contribute](CONTRIBUTING.md)
101
+
102
+ ## License
103
+
104
+ The original Streonor MCP code and documentation are available under the [MIT License](LICENSE). STREONOR’s name identifies compatible products. The vendor software, trademarks, and linked material belong to their respective owners and are outside the scope of this license.
@@ -0,0 +1,20 @@
1
+ # Security
2
+
3
+ This local server can read profiles and edit their actions. Connect only trusted clients.
4
+ Stdio needs no HTTP token. HTTP binds to loopback and requires its generated Bearer token.
5
+ Do not expose the endpoint publicly or commit `token.txt`, client secrets or personal profiles.
6
+
7
+ Preview hashes prevent stale writes, backups preserve the preceding manifest, and paths are
8
+ validated inside the configured profile root. These are safeguards, not a sandbox for an
9
+ untrusted agent. A client can still request harmful configurations or force-close the vendor app.
10
+
11
+ Cooperating MCP instances serialize edits with an advisory lock in the profile root. The
12
+ vendor app and unrelated editors do not honor that lock, so process and hash checks remain
13
+ necessary. Do not use a shared profile while its vendor app runs on another computer or OS.
14
+ Input limits are 32 MiB per manifest and 16 MiB / 16 million pixels per icon. Standalone image
15
+ outputs are published without replacing an existing file. Failed profile edits remove their
16
+ uncommitted icon files. backups are retained. No backup pruning occurs automatically.
17
+
18
+ Report vulnerabilities privately using GitHub's private vulnerability reporting when available.
19
+ If private reporting is unavailable, contact the repository owner directly. Keep credentials
20
+ and vulnerability details out of public issues.
@@ -0,0 +1,42 @@
1
+ # Capability coverage
2
+
3
+ Every registered MCP tool is invoked by `tests/test_mcp.py`. The test compares the invoked
4
+ names with actual tool discovery and fails if an exposed tool is missing coverage.
5
+
6
+ | Capability | Implementation | Verification |
7
+ | --- | --- | --- |
8
+ | Device registry | Known model metadata. S6 supported | Protocol test and prior S6 Windows observations |
9
+ | Installed action discovery | Vendor plugin manifests | Protocol fixture |
10
+ | Profile/page inspection | Read existing manifests and hashes | Protocol fixture. actual Development read |
11
+ | Page reordering | Validated permutation of the existing page IDs | Protocol fixture |
12
+ | Control backup restoration | Scene and page scoped backups with two preview hashes | Protocol fixture |
13
+ | Existing key/knob settings | Preview, matching JSON types, guarded apply | Protocol fixture preserving knob settings. prior Windows knob observations |
14
+ | Clone/create-from-template/remove | Existing same-page single actions | Unit and protocol fixtures |
15
+ | Ordered action flows | Replace target with native sequential Multi Action | Order/copy/validation tests and protocol write/read-back |
16
+ | Icon set/reuse/clear | Normalized PNG copies | Unit and protocol fixtures. prior S6 Windows icon observations |
17
+ | Icon preparation | 1254 x 1254 PNG. padding and no-overwrite | Unit and protocol fixtures |
18
+ | Boot artwork preparation | Registry dimensions. PNG output | Unit and protocol fixtures |
19
+ | Scene creation from selected controls | New profile, optional copied actions/icons and SQLite catalog row | Protocol fixture, empty-actions check, registration and duplicate rejection |
20
+ | Scene rename/delete | Hash-checked name changes and catalog removal with folder archival | Protocol CRUD tests |
21
+ | Name-based Toolbox slots | Installed metadata, controller checks and explicit configuration status | Protocol and catalog construction checks |
22
+ | Multi-step hotkeys | Per-step chords and delays | Modifier, slot, order and protocol tests |
23
+ | Automatic icons | Local app/pack matching with a generated label fallback | SVG contrast, fallback, opt-out and protocol tests |
24
+ | Solid icon backgrounds | Optional RGB fill and edge-connected background replacement | Pixel/color regression test |
25
+ | App close/reopen | Windows only, explicit forced exit option | Unit failure cases and prior Windows integration checks |
26
+ | Live scene copies | Native Windows scene import with page and action read-back | S6 Mini import, setting/icon edits, multi-page layout and Gaming scene flow/icon edits. Original app PID verified |
27
+ | Live in-place Scene Shift icon | Windows property inspector and native file picker | Gaming scene ID, settings, image pixels and app process verified |
28
+ | Backups/stale-write prevention | Manifest/catalog snapshots and hashes | Unit and protocol fixtures |
29
+ | Concurrent cooperating MCP editors | Advisory profile-root lock | Cross-process test |
30
+ | HTTP authentication | Loopback, Bearer token, duplicate-header rejection | ASGI authentication tests |
31
+ | Stdio transport | MCP SDK | Real subprocess protocol tests |
32
+
33
+ ## Unsupported or unverified
34
+
35
+ Direct USB control, firmware writes, boot-logo uploads, live device event streaming, arbitrary
36
+ Toolbox invocation, page creation/deletion, and other in-place live edits of native scenes
37
+ are not implemented. Scene creation
38
+ requires the observed vendor catalog schema. unknown schemas fail closed. macOS/Linux hardware
39
+ and automatic app lifecycle are not verified. A sequence requests actions in order but cannot
40
+ guarantee that an app has finished loading before the next action starts.
41
+
42
+ Installed actions can be constructed from their name or UUID using native metadata. Unknown plugin settings are not invented. Actions without a published settings schema still require native-app verification. Existing source templates remain supported. Whole-app execution parity is not claimed.
@@ -0,0 +1,99 @@
1
+ # Everyday workflows
2
+
3
+ You can make these requests in plain language. The agent should identify the scene and control, preview the change, and verify the saved result. A scene is a layout of device controls. A flow is one button that performs several steps.
4
+
5
+ ## Create: set up a work layout
6
+
7
+ > “Create a Work scene with email, calendar and GitHub buttons. Use the volume knob from my Daily scene.”
8
+
9
+ The agent reads Daily to find those existing controls. It previews and creates Work with the requested `include_coordinates`. Their settings and PNG icons are copied. The original scene stays intact.
10
+
11
+ > “Add a Calculator shortcut to Work.”
12
+
13
+ The agent finds Calculator in `list_available_actions`, then previews `create_by_name` with `action_name="Calculator"` at an empty position. It applies the preview hash and reads back the new action. It does not need an existing Calculator button to copy.
14
+
15
+ If a name is ambiguous, the agent should use `plugin/name` or the exact UUID. Actions restricted to flows cannot be placed directly on a key. Actions that require a secondary screen are not suitable for every device.
16
+
17
+ ## Read: understand an existing setup
18
+
19
+ > “What do my Work buttons and knobs currently do?”
20
+
21
+ The agent uses `list_profiles` and `read_profile`. It describes the saved actions, destinations and flows. It should not change anything. Listing an installed Toolbox item only establishes that its plugin metadata is present.
22
+
23
+ ## Update: point a button at your project
24
+
25
+ > “Change GitHub to open my repository's issues page. Keep its black icon.”
26
+
27
+ The agent locates the existing Website action, previews its `path` setting and applies the returned hash. It uses `auto_icon=false` to preserve the explicitly requested icon. Ordinary destination changes refresh the associated icon by default.
28
+
29
+ > “Use this image for the Calendar button.”
30
+
31
+ The agent previews and applies `set_icon`. PNG, JPEG, BMP, GIF, WebP and self-contained SVG icons are supported. Images become 1254 x 1254 PNGs. Originals are retained.
32
+
33
+ ## Create: start a coding session
34
+
35
+ > “Make Start Coding open VS Code, wait half a second, then open Terminal.”
36
+
37
+ The agent can build a `set_flow` from existing OpenApps settings and the installation's own app list. It must look up the current app IDs instead of reusing IDs from another computer. Flows support existing `source_coordinate` templates and installed `action_name` entries. The latter accept user-supplied `settings` when a plugin needs them.
38
+
39
+ Use a `flow_title` such as Start Coding and ordered `flow_steps` with `delay_ms`. Each launch is requested in sequence. The flow cannot guarantee an app has finished loading before the next step starts.
40
+
41
+ ## Create: run several keyboard shortcuts
42
+
43
+ > “Copy the selected text, switch to the previous app, then paste it.”
44
+
45
+ The agent creates a `set_flow` using these steps:
46
+
47
+ ```json
48
+ {
49
+ "operation": "set_flow",
50
+ "flow_title": "Copy to previous app",
51
+ "flow_steps": [
52
+ {"action_name": "com.hotspot.streamdock.system.hotkey", "hotkey": "Ctrl+C"},
53
+ {"action_name": "com.hotspot.streamdock.system.hotkey", "hotkey": "Alt+Tab", "delay_ms": 300},
54
+ {"action_name": "com.hotspot.streamdock.system.hotkey", "hotkey": "Ctrl+V", "delay_ms": 300}
55
+ ]
56
+ }
57
+ ```
58
+
59
+ The agent supplies the actual profile and coordinate, previews this flow and applies it with the returned hash. Modifiers belong to each step. Ctrl+C is a chord, while the flow is the sequence. These shortcuts act on the focused applications. Verify focus before testing. Saved format and order are automated-test covered, but arbitrary hotkey execution is not universally hardware-verified.
60
+
61
+ ## Icons: get a useful image automatically
62
+
63
+ > “Add a GitHub shortcut.”
64
+
65
+ An associated icon is assumed. The server prefers an explicit image, then a matching installed app or icon-pack image. Existing custom template icons are preserved unless a new icon query or destination requests a replacement. If there is no suitable local match, it creates a black label icon. A label is not an official brand logo.
66
+
67
+ `resolve_icon(query)` also returns a prepared path, origin and hash for explicit icon requests. It makes no network requests. Agents may obtain external logos using their other authorized tools, then pass those local files to MCP.
68
+
69
+ > “Give GitHub a black background.”
70
+
71
+ The agent uses `prepare_icon` with `background_color="#000000"` and, for a connected opaque background, `replace_edge_background=true`. It then applies the resulting file to the selected action. Check the preview because edge-connected artwork sharing the background color can also be recolored.
72
+
73
+ > “Create this button without an icon.”
74
+
75
+ The agent disables automatic icon selection and uses `clear_icon` if the selected template already has one.
76
+
77
+ ## Update: change a knob or an action flow
78
+
79
+ > “Copy the zoom knob into Work, then remove the old test binding.”
80
+
81
+ The agent can copy selected source controls into a new scene or clone a same-page action into an empty position. Existing knob settings are edited with the setting preview/apply tools. It should preserve controls you did not request to change.
82
+
83
+ > “Add a longer pause before Terminal opens.”
84
+
85
+ The agent reads the current flow, changes the relevant step's delay and previews `set_flow` again. It applies the revised flow in one guarded write.
86
+
87
+ ## Delete: clean up a layout
88
+
89
+ > “Remove Start Coding and the test knob. Keep my volume control.”
90
+
91
+ The agent identifies the exact coordinates, previews `remove` for each, applies the hashes, and verifies their absence. This removes device assignments. It does not uninstall applications.
92
+
93
+ > “Rename Temp to Weekend. Later, delete Weekend.”
94
+
95
+ The agent uses `preview_scene_change` and `apply_scene_change` for rename or delete. Deletion unregisters the scene and archives its entire folder under `.streonor-deleted-scenes`. Its catalog is backed up too. Deleting the last registered scene is refused. No automatic restore tool is available yet.
96
+
97
+ ## When an action still needs setup
98
+
99
+ Some Toolbox items need OBS, an account, a file, a device feature or plugin-specific settings. `create_by_name` creates their native slot using installed metadata. It reports `execution_verified=false`. `configure_action` can supply a complete settings object, but the plugin remains responsible for runtime validation when no settings schema is published. The agent should disclose missing configuration rather than promise the action works.