deep-roon-mcp 0.4.9 → 0.5.0

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 CHANGED
@@ -22,7 +22,7 @@ server of its own and sends nothing anywhere else. What you ask goes to your MCP
22
22
 
23
23
  ## Status
24
24
 
25
- Version 0.4: fifty-nine tools. Qobuz, TIDAL or both — whatever is signed in on your Core.
25
+ Version 0.5: fifty-nine tools (fifty-three with a read-only library). Qobuz, TIDAL or both — whatever is signed in on your Core.
26
26
 
27
27
  **Reading** — changes nothing in Roon:
28
28
 
@@ -80,7 +80,14 @@ Version 0.4: fifty-nine tools. Qobuz, TIDAL or both — whatever is signed in on
80
80
  | `roon_play_mix` | One of today's Daily Mixes |
81
81
  | `roon_play_radio` | A Live Radio station on a zone |
82
82
 
83
- **Changing your library or sound** — only on your request; each one reads the result back and says if Roon didn't follow:
83
+ **Changing your library or sound** — only on your request; each one reads the result back and says if Roon didn't follow.
84
+
85
+ > **A word of care.** These six tools write into your Core's library and settings through Roon's *internal* protocol —
86
+ > the same wiring Roon's own apps use, but not an API Roon Labs supports for others. Deep Roon is careful with it (one
87
+ > change at a time, read back, nothing in bulk), but a Roon update can change that wiring under it. **Keep a recent backup
88
+ > of your Roon database** (Roon › Settings › Backups) before you let an assistant change things — and if you only want to
89
+ > ask and listen, switch on **Read-only library** below: then these six tools aren't there at all.
90
+
84
91
 
85
92
  | Tool | What it does |
86
93
  |---|---|
@@ -111,6 +118,7 @@ The settings (Claude Desktop › Settings › Extensions › Deep Roon MCP):
111
118
  | Roon Core address | Empty: found on your network. Fill in the Core's address for another subnet or a private VPN (Tailscale) |
112
119
  | Essentials only | Seventeen tools instead of fifty-nine, for small models |
113
120
  | Use Roon's internal protocol | Off: only the official API — zones, playback, volume, grouping; no search, reviews, Focus or history |
121
+ | Read-only library | On: Deep Roon never changes your library — no playlists, hearts, Listen Later, library additions or DSP. Playing still works |
114
122
 
115
123
  ### Other clients
116
124
 
@@ -136,7 +144,7 @@ or by hand in `~/.codex/config.toml`:
136
144
  [mcp_servers.deep-roon]
137
145
  command = "npx"
138
146
  args = ["-y", "deep-roon-mcp"]
139
- # env = { ROON_HOST = "", DEEP_ROON_TOOLS = "", DEEP_ROON_INTERNAL = "" }
147
+ # env = { ROON_HOST = "", DEEP_ROON_TOOLS = "", DEEP_ROON_INTERNAL = "", DEEP_ROON_READ_ONLY = "" }
140
148
  ```
141
149
 
142
150
  ChatGPT on the web can't run a server on your computer — use the desktop app.
@@ -149,14 +157,15 @@ ChatGPT on the web can't run a server on your computer — use the desktop app.
149
157
  "deep-roon": {
150
158
  "command": "npx",
151
159
  "args": ["-y", "deep-roon-mcp"],
152
- "env": { "ROON_HOST": "", "DEEP_ROON_TOOLS": "", "DEEP_ROON_INTERNAL": "" }
160
+ "env": { "ROON_HOST": "", "DEEP_ROON_TOOLS": "", "DEEP_ROON_INTERNAL": "", "DEEP_ROON_READ_ONLY": "" }
153
161
  }
154
162
  }
155
163
  }
156
164
  ```
157
165
 
158
- The same three settings as environment variables: `ROON_HOST` (the Core's address, empty = find it), `DEEP_ROON_TOOLS=essentials`,
159
- `DEEP_ROON_INTERNAL=off`. Leave out what you don't need. VS Code calls the block `"servers"` instead of `"mcpServers"`.
166
+ The same settings as environment variables: `ROON_HOST` (the Core's address, empty = find it), `DEEP_ROON_TOOLS=essentials`,
167
+ `DEEP_ROON_INTERNAL=off`, `DEEP_ROON_READ_ONLY=library` (nothing changes the library; playing works) or `DEEP_ROON_READ_ONLY=all`
168
+ (Deep Roon only looks: no playing, queueing or zone changes either). Leave out what you don't need. VS Code calls the block `"servers"` instead of `"mcpServers"`.
160
169
 
161
170
  Then, once, in Roon: Settings › Extensions › **Enable** next to "Deep Roon MCP". Until then the tools say so.
162
171
 
@@ -42,6 +42,7 @@ var __toESM = (mod, isNodeMode, target2) => (target2 = mod != null ? __create(__
42
42
  isNodeMode || !mod || !mod.__esModule ? __defProp(target2, "default", { value: mod, enumerable: true }) : target2,
43
43
  mod
44
44
  ));
45
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
45
46
 
46
47
  // node_modules/ajv/dist/compile/codegen/code.js
47
48
  var require_code = __commonJS({
@@ -15525,7 +15526,7 @@ var require_lib2 = __commonJS({
15525
15526
  var version2;
15526
15527
  var init_package = __esm({
15527
15528
  "package.json"() {
15528
- version2 = "0.4.9";
15529
+ version2 = "0.5.0";
15529
15530
  }
15530
15531
  });
15531
15532
 
@@ -17020,6 +17021,8 @@ var init_focus = __esm({
17020
17021
  });
17021
17022
 
17022
17023
  // src/index.ts
17024
+ var index_exports = {};
17025
+ module.exports = __toCommonJS(index_exports);
17023
17026
  var import_http = __toESM(require("http"));
17024
17027
 
17025
17028
  // node_modules/zod/v3/helpers/util.js
@@ -51885,30 +51888,53 @@ var INSTRUCTIONS = `Deep Roon MCP connects to the user's own Roon Core (music pl
51885
51888
  - What plays changes all the time: read roon_now_playing afresh before describing it.
51886
51889
  - "Daily Mixes" are Roon's own (roon_mixes); the user's TIDAL mixes (My Mix 1 \u2026, My Daily Discovery) are roon_tidal_playlists with shelf my_mixes, and their tracks can be read with roon_playlist.
51887
51890
  - Unofficial: this uses Roon's internal protocol, which a Roon update can change; if a tool says so, tell the user to check for an update.`;
51888
- function buildServer(internal, essentials) {
51889
- const server = new McpServer({ name: "deep-roon-mcp", title: "Deep Roon MCP", version: version2, websiteUrl: "https://github.com/renebouwmeester/deep-roon-mcp" }, { instructions: INSTRUCTIONS });
51890
- if (essentials) {
51891
- const keep = /* @__PURE__ */ new Set([
51892
- "roon_status",
51893
- "roon_search",
51894
- "roon_album",
51895
- "roon_review",
51896
- "roon_bio",
51897
- "roon_artist",
51898
- "roon_zones",
51899
- "roon_now_playing",
51900
- "roon_play",
51901
- "roon_play_tracks",
51902
- "roon_control",
51903
- "roon_volume",
51904
- "roon_queue",
51905
- "roon_playlists",
51906
- "roon_play_playlist",
51907
- "roon_daily_picks",
51908
- "roon_top"
51909
- ]);
51891
+ var LIBRARY_WRITES = /* @__PURE__ */ new Set(["roon_playlist_create", "roon_favorite", "roon_radio_favorite", "roon_listen_later_set", "roon_library_add", "roon_dsp_set"]);
51892
+ var PLAYBACK = /* @__PURE__ */ new Set([
51893
+ "roon_play",
51894
+ "roon_play_tracks",
51895
+ "roon_play_radio",
51896
+ "roon_play_mix",
51897
+ "roon_play_playlist",
51898
+ "roon_control",
51899
+ "roon_seek",
51900
+ "roon_volume",
51901
+ "roon_settings",
51902
+ "roon_queue_jump",
51903
+ "roon_queue_remove",
51904
+ "roon_queue_move",
51905
+ "roon_queue_clear",
51906
+ "roon_transfer",
51907
+ "roon_group",
51908
+ "roon_ungroup",
51909
+ "roon_sleep",
51910
+ "roon_standby"
51911
+ ]);
51912
+ function buildServer(internal, essentials, readOnly = "off") {
51913
+ const instructions = readOnly === "off" ? INSTRUCTIONS : INSTRUCTIONS + (readOnly === "all" ? "\n- Read-only (set by the user): Deep Roon only looks \u2014 it can't play, queue, change a zone, or change the library. Say so when asked." : "\n- Read-only library (set by the user): Deep Roon can play and control zones, but it can't change the library, playlists, hearts, Listen Later or DSP. Say so when asked.");
51914
+ const server = new McpServer({ name: "deep-roon-mcp", title: "Deep Roon MCP", version: version2, websiteUrl: "https://github.com/renebouwmeester/deep-roon-mcp" }, { instructions });
51915
+ const essentialSet = /* @__PURE__ */ new Set([
51916
+ "roon_status",
51917
+ "roon_search",
51918
+ "roon_album",
51919
+ "roon_review",
51920
+ "roon_bio",
51921
+ "roon_artist",
51922
+ "roon_zones",
51923
+ "roon_now_playing",
51924
+ "roon_play",
51925
+ "roon_play_tracks",
51926
+ "roon_control",
51927
+ "roon_volume",
51928
+ "roon_queue",
51929
+ "roon_playlists",
51930
+ "roon_play_playlist",
51931
+ "roon_daily_picks",
51932
+ "roon_top"
51933
+ ]);
51934
+ const keep = /* @__PURE__ */ __name((name) => (!essentials || essentialSet.has(name)) && !(readOnly !== "off" && LIBRARY_WRITES.has(name)) && !(readOnly === "all" && PLAYBACK.has(name)), "keep");
51935
+ if (essentials || readOnly !== "off") {
51910
51936
  const original = server.registerTool.bind(server);
51911
- server.registerTool = (name, cfg, cb) => keep.has(name) ? original(name, cfg, cb) : void 0;
51937
+ server.registerTool = (name, cfg, cb) => keep(name) ? original(name, cfg, cb) : void 0;
51912
51938
  }
51913
51939
  registerStatusTool(server, internal);
51914
51940
  registerReadTools(server, internal);
@@ -51917,7 +51943,7 @@ function buildServer(internal, essentials) {
51917
51943
  return server;
51918
51944
  }
51919
51945
  __name(buildServer, "buildServer");
51920
- function serveHttp(spec, internal, essentials) {
51946
+ function serveHttp(spec, internal, essentials, readOnly) {
51921
51947
  const m = /^(?:(.+):)?(\d+)$/.exec(spec.trim());
51922
51948
  if (!m) {
51923
51949
  log(`DEEP_ROON_HTTP should be [host:]port, not "${spec}"`);
@@ -51942,7 +51968,7 @@ function serveHttp(spec, internal, essentials) {
51942
51968
  res.writeHead(400).end("Parse error");
51943
51969
  return;
51944
51970
  }
51945
- const server = buildServer(internal, essentials);
51971
+ const server = buildServer(internal, essentials, readOnly);
51946
51972
  const transport2 = new StreamableHTTPServerTransport({ sessionIdGenerator: void 0, enableJsonResponse: true });
51947
51973
  res.on("close", () => {
51948
51974
  transport2.close().catch(() => {
@@ -51964,14 +51990,16 @@ __name(serveHttp, "serveHttp");
51964
51990
  async function main() {
51965
51991
  const internal = !/^(off|false|0|no)$/i.test(process.env.DEEP_ROON_INTERNAL ?? "");
51966
51992
  const essentials = /^(essentials|true|1|yes)$/i.test(process.env.DEEP_ROON_TOOLS ?? process.env.DEEP_ROON_ESSENTIALS ?? "");
51993
+ const ro = (process.env.DEEP_ROON_READ_ONLY ?? "").trim().toLowerCase();
51994
+ const readOnly = ro === "all" ? "all" : /^(library|true|1|yes)$/.test(ro) ? "library" : "off";
51967
51995
  if (internal) afterFirstConnect(() => selfTest(runSelfTest));
51968
51996
  checkForUpdate().catch(() => {
51969
51997
  });
51970
- log(`${internal ? "internal protocol on" : "internal protocol OFF \u2014 official API only"}${essentials ? ", essentials" : ""}`);
51998
+ log(`${internal ? "internal protocol on" : "internal protocol OFF \u2014 official API only"}${essentials ? ", essentials" : ""}${readOnly === "off" ? "" : readOnly === "all" ? ", READ-ONLY (looks only)" : ", read-only library"}`);
51971
51999
  const httpSpec = process.env.DEEP_ROON_HTTP;
51972
- if (httpSpec) serveHttp(httpSpec, internal, essentials);
52000
+ if (httpSpec) serveHttp(httpSpec, internal, essentials, readOnly);
51973
52001
  else {
51974
- await buildServer(internal, essentials).connect(new StdioServerTransport());
52002
+ await buildServer(internal, essentials, readOnly).connect(new StdioServerTransport());
51975
52003
  log(`${version2} ready (stdio)`);
51976
52004
  process.stdin.on("close", () => {
51977
52005
  shutdown();
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "deep-roon-mcp",
3
- "version": "0.4.9",
3
+ "version": "0.5.0",
4
4
  "description": "An MCP server for Roon that reaches the parts the official API doesn't: reviews, biographies, Qobuz's and TIDAL's shelves, TIDAL's playlists, your history, search across your library and the streaming services",
5
5
  "license": "Apache-2.0",
6
6
  "author": "René Bouwmeester <21277119+renebouwmeester@users.noreply.github.com>",