stagebook-mcp 0.1.0 → 0.1.2

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
@@ -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
@@ -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
 
@@ -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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stagebook-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "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",
@@ -36,7 +36,7 @@
   },
   "scripts": {
     "build": "tsc",
-    "test": "npm run build && node --test test/",
+    "test": "npm run build && node --test \"test/*.test.mjs\"",
     "start": "node dist/index.js",
     "prepack": "npm run build && cp ../LICENSE.md LICENSE.md",
     "prepublishOnly": "npm test"