stagebook-mcp 0.1.1 → 0.1.3

package/README.md

@@ -2,6 +2,8 @@
 
 **English** · [Português (Brasil)](README.pt-BR.md)
 
+[![npm](https://img.shields.io/npm/v/stagebook-mcp)](https://www.npmjs.com/package/stagebook-mcp)
+
 Lets AI assistants read and edit the songs and setlists on your Stagebook tablet: "build a 15-song setlist for Saturday
 without repeating artists", "move every Skank song down a half tone", "check the chords of Hazard", "import this page".
 It's a [Model Context Protocol](https://modelcontextprotocol.io) server that runs on your computer and talks to the
@@ -19,7 +21,7 @@ Windsurf, Gemini CLI, OpenAI Codex CLI…).
 | Songs | `list_songs` (filters: text, tag, key), `get_song`, `create_song`, `update_song`, `delete_song`, `transpose_song`, `set_capo` |
 | Import | `import_song` (pasted lyrics/chords in any common format, or a song page address) |
 | Backing tracks | `set_backing_track` (OGG, MP3 or WAV from this computer), `remove_backing_track` |
-| Setlists | `list_setlists`, `get_setlist`, `create_setlist`, `update_setlist`, `delete_setlist` |
+| Setlists | `list_setlists` (filter: name), `setlist_order` (newest or A to Z, the same as the app's tab), `get_setlist`, `create_setlist`, `update_setlist`, `delete_setlist` |
 | Receiving | `receive_by_code` (the 3 words), `receive_create`, `band_inbox`, `band_sync`, `open_band_item` |
 | Backup | `restore_backup` (inspect a `.stagebook` file, add what's missing or replace the library) |
 
@@ -34,14 +36,11 @@ Files to send (backing tracks, backups) take a full path; `~` is your home folde
 
 ## Install
 
-Needs [Node.js](https://nodejs.org) 20 or newer.
+Needs [Node.js](https://nodejs.org) 20 or newer. The server is on npm as
+[`stagebook-mcp`](https://www.npmjs.com/package/stagebook-mcp): nothing to download from GitHub.
 
-```sh
-npx -y stagebook-mcp
-```
-
-That's the server: your assistant starts it by itself with the settings below (`npx` downloads it the first time and
-keeps it up to date), so there's nothing to run by hand.
+You don't run it by hand: your assistant starts it by itself with the settings below (`npx` downloads it the first time and
+keeps it up to date). Run by hand, it just waits for an assistant: Ctrl+C closes it.
 
 ## Connect your assistant
 
@@ -119,6 +118,8 @@ conversation. Lyrics are copyrighted: the server tells the assistant not to repr
 
 ## Development
 
+Only to change the server itself; to use it, [Install](#install) is all you need.
+
 ```sh
 git clone https://github.com/julianoAffonso/stagebook.git
 cd stagebook/mcp

package/README.pt-BR.md

@@ -2,6 +2,8 @@
 
 [English](README.md) · **Português (Brasil)**
 
+[![npm](https://img.shields.io/npm/v/stagebook-mcp)](https://www.npmjs.com/package/stagebook-mcp)
+
 Deixa assistentes de IA lerem e editarem as músicas e os setlists do seu tablet com o Stagebook: "monta um setlist de
 15 músicas para sábado sem repetir artista", "passa todas as do Skank meio tom abaixo", "confere os acordes de Hazard",
 "importa esta página". É um servidor [Model Context Protocol](https://modelcontextprotocol.io) que roda no seu computador
@@ -19,7 +21,7 @@ Copilot, Windsurf, Gemini CLI, OpenAI Codex CLI…).
 | Músicas | `list_songs` (filtros: texto, tag, tom), `get_song`, `create_song`, `update_song`, `delete_song`, `transpose_song`, `set_capo` |
 | Importar | `import_song` (letra e cifra coladas em qualquer formato comum, ou o endereço de uma página) |
 | Backing tracks | `set_backing_track` (OGG, MP3 ou WAV do computador), `remove_backing_track` |
-| Setlists | `list_setlists`, `get_setlist`, `create_setlist`, `update_setlist`, `delete_setlist` |
+| Setlists | `list_setlists` (filtro: nome), `setlist_order` (recentes ou A a Z, o mesmo da aba do app), `get_setlist`, `create_setlist`, `update_setlist`, `delete_setlist` |
 | Receber | `receive_by_code` (as 3 palavras), `receive_create`, `band_inbox`, `band_sync`, `open_band_item` |
 | Backup | `restore_backup` (ver o que um arquivo `.stagebook` tem, juntar o que falta ou substituir a biblioteca) |
 
@@ -36,14 +38,11 @@ param também.
 
 ## Instalar
 
-Precisa do [Node.js](https://nodejs.org) 20 ou mais novo.
+Precisa do [Node.js](https://nodejs.org) 20 ou mais novo. O servidor está no npm como
+[`stagebook-mcp`](https://www.npmjs.com/package/stagebook-mcp): nada para baixar do GitHub.
 
-```sh
-npx -y stagebook-mcp
-```
-
-Esse é o servidor: o assistente abre ele sozinho com os ajustes abaixo (o `npx` baixa da primeira vez e mantém
-atualizado), então não precisa rodar nada à mão.
+Não precisa rodar à mão: o assistente abre ele sozinho com os ajustes abaixo (o `npx` baixa da primeira vez e mantém
+atualizado). Rodado à mão, ele só fica esperando um assistente: Ctrl+C fecha.
 
 ## Ligar no seu assistente
 
@@ -86,7 +85,7 @@ O app do ChatGPT só se conecta a servidores remotos (pela internet), então nã
 2. Peça ao assistente para conectar no Stagebook. Ele procura na rede (ou você passa o endereço) e o tablet mostra um
    pedido com um código. Se mais de um tablet com o Stagebook responder (uma banda no mesmo Wi-Fi), ele pergunta qual
    endereço é o seu; se o endereço do seu tablet mudou, ele procura de novo.
-3. Se o código bater, toque em **Permitir** no tablet. A chave fica guardada neste computador
+3. Se o código bater, toque em **Autorizar** no tablet. A chave fica guardada neste computador
    (`~/.config/stagebook-mcp/config.json`, que só você lê); da próxima vez ele conecta sem perguntar.
 
 O editor desliga sozinho no tablet quando fica sem uso: ligue de novo quando quiser usar o assistente. A chave dura 90
@@ -109,7 +108,7 @@ dias sem uso; **Ajustes → Editar no computador → Computadores autorizados**
   Abra **Ajustes do Sistema → Privacidade e Segurança → Rede Local** e ligue o app que roda o assistente (Claude,
   Terminal, iTerm, Cursor, VS Code…). Depois reabra esse app.
 - **"No longer accepts this computer's key"**: a chave foi removida no tablet ou passou 90 dias sem uso. Conecte de novo.
-- **"Already showing a request, or one was just denied"**: responda o pedido no tablet; depois de um Negar, ele espera
+- **"Already showing a request, or one was just denied"**: responda o pedido no tablet; depois de um Recusar, ele espera
   5 minutos para aceitar outro.
 - **"Not found on the tablet, or that part is turned off"**: receber por código precisa da internet ligada, e as
   ferramentas de banda precisam da banda ligada, nos Ajustes do tablet.
@@ -122,6 +121,8 @@ têm direito autoral: o servidor orienta o assistente a não reproduzi-las intei
 
 ## Para quem programa
 
+Só para mudar o próprio servidor; para usar, basta o [Instalar](#instalar).
+
 ```sh
 git clone https://github.com/julianoAffonso/stagebook.git
 cd stagebook/mcp

package/dist/index.js

@@ -4,6 +4,11 @@
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { StagebookClient } from "./client.js";
 import { buildServer } from "./server.js";
+// Run by hand in a terminal it just waits for an assistant, which looks frozen: say so (stderr, never the protocol)
+if (process.stdin.isTTY) {
+    process.stderr.write("Stagebook MCP server: running and waiting for an AI assistant. Nothing to do here: your assistant starts it by\n" +
+        "itself (setup: https://github.com/julianoAffonso/stagebook/tree/main/mcp). Press Ctrl+C to close.\n");
+}
 const client = await StagebookClient.fromEnv();
 const server = buildServer(client);
 await server.connect(new StdioServerTransport());

package/dist/server.js

@@ -250,10 +250,21 @@ export function buildServer(client) {
     // ---------- setlists ----------
     server.registerTool("list_setlists", {
         title: "List setlists",
-        description: "The setlists (id, name, number of songs).",
-        inputSchema: {},
+        description: "The setlists (id, name, number of songs), in the order the app's Setlists tab shows them. Optional filter.",
+        inputSchema: { query: z.string().optional().describe("Part of the name (accents and case ignored).") },
         annotations: { readOnlyHint: true },
-    }, safe(async () => text(await client.get("/api/sets"))));
+    }, safe(async ({ query }) => {
+        const sets = (await client.get("/api/sets"));
+        return text(query ? sets.filter((s) => norm(s.name).includes(norm(query))) : sets);
+    }));
+    server.registerTool("setlist_order", {
+        title: "Setlists order",
+        description: "Reads the order of the app's Setlists tab or, with order, changes it there: newest first or A to Z.",
+        inputSchema: { order: z.enum(["newest", "abc"]).optional().describe("Leave it out to only read the current order.") },
+    }, safe(async ({ order }) => {
+        const now = order ? await client.send("PUT", "/api/sets-order", { abc: order === "abc" }) : await client.get("/api/sets-order");
+        return text({ order: now.abc ? "abc" : "newest" });
+    }));
     server.registerTool("get_setlist", {
         title: "Get a setlist",
         description: "A setlist with its songs in order (a song deleted from the library shows with an empty title).",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stagebook-mcp",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "MCP server for Stagebook: lets AI assistants (Claude Code, Claude Desktop, Cursor, VS Code, Gemini CLI, Codex…) read and edit the songs and setlists on your Stagebook tablet over the local network.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Juliano Affonso",