@hidechae/eztab-mcp 0.5.1 → 0.5.2

package/README.md

@@ -113,7 +113,7 @@ Run standalone for testing: `task mcp` (or `npx tsx mcp/server.ts`).
 - コードは track 0 のもの(`set_chords` は track 0 の列で指定)。`write_measures(track > 0)` ではコード指定と、
   既存小節の拍子を変える `time` を拒否する
 - `get_tab` は全パートを小節ごとに並べて表示する(`track` で1パートに絞れる)
-- `send_to_eztab` は対応する最新の形式リビジョンをヘッダーに付けて送る(0.5.1では `5`)。
+- `send_to_eztab` は対応する最新の形式リビジョンをヘッダーに付けて送る(0.5.2では `6`)。
   対応上限を超える形式のタブは閲覧のみで、編集・送信できない。
   0.2.0以前のMCPは複数パートのタブを送り返せない(サーバが409で拒否する)。
 
@@ -146,3 +146,5 @@ Claude Desktop では入力欄の「＋」→ eztab → `import_tab_from_image`
 EZTab のモデルに無い記譜(スライド・ハンマリング・プリング → タイ/スラー、
 ハーモニクス・ビブラート・装飾音 → 主音のみ等)の寄せ方は手順書
 ([prompts.ts](prompts.ts))に書いてあり、書き起こし後に簡略化した箇所を報告させる。
+
+0.5.2以降は曲全体のMarkdownメモ（形式リビジョン6）を既存の編集・送信操作で保持します。曲メモの入力・表示はwebアプリで行います。

package/dist/server.js

@@ -7,7 +7,8 @@ import { z } from "zod";
 
 // ../src/types/tab.ts
 var TAB_FILE_VERSION = 1;
-var SUPPORTED_FORMAT_REVISION = 5;
+var SUPPORTED_FORMAT_REVISION = 6;
+var SONG_MEMO_FORMAT_REVISION = 6;
 var MULTI_TRACK_FORMAT_REVISION = 2;
 var HARMONICS_FORMAT_REVISION = 3;
 var TEMPO_CHANGES_FORMAT_REVISION = 4;
@@ -252,10 +253,24 @@ function normalizeChords(raw, subdivisions) {
   }
   return out;
 }
+var MAX_SONG_MEMO_LENGTH = 1e4;
+var DocumentValidationError = class extends Error {
+};
+function normalizeSongMemo(raw) {
+  if (typeof raw !== "string") return void 0;
+  const memo = raw.replace(/\r\n?/g, "\n");
+  if (memo.length > MAX_SONG_MEMO_LENGTH) {
+    throw new DocumentValidationError(`\u66F2\u30E1\u30E2\u306F${MAX_SONG_MEMO_LENGTH}\u6587\u5B57\u4EE5\u5185\u306B\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);
+  }
+  return memo.trim() ? memo : void 0;
+}
 function normalizeDocument(data) {
   if (!data || !Array.isArray(data.tuning) || !Array.isArray(data.measures)) {
     throw new Error("Not a valid EZTab document");
   }
+  const memo = normalizeSongMemo(data.memo);
+  if (memo === void 0) delete data.memo;
+  else data.memo = memo;
   data.measures = data.measures.map((m) => {
     let beats = m.beats;
     let rawSubs = m.subdivisions;
@@ -278,14 +293,14 @@ function normalizeDocument(data) {
     );
     const rawChords = Array.isArray(m.chords) ? m.chords : typeof m.chord === "string" && m.chord ? [m.chord] : [];
     const chords = normalizeChords(rawChords, subdivisions);
-    const memo = normalizeMeasureMemo(m.memo);
+    const memo2 = normalizeMeasureMemo(m.memo);
     return {
       beats,
       beatUnit,
       subdivisions,
       cells,
       chords,
-      ...memo !== void 0 ? { memo } : {}
+      ...memo2 !== void 0 ? { memo: memo2 } : {}
     };
   });
   if (!Array.isArray(data.keys) || data.keys.length === 0) {
@@ -536,7 +551,7 @@ function mainMeasures(doc) {
 }
 function closeWorkspace(doc) {
   const ws = doc.workspace;
-  if (!ws) return doc;
+  if (!ws) return closeWorkspace(openWorkspace(doc));
   const bodies = trackBodies(doc);
   const main = bodies[0];
   const {
@@ -546,6 +561,7 @@ function closeWorkspace(doc) {
     tracks: _tr,
     formatRevision,
     tempoChanges: rawTempoChanges,
+    memo: rawMemo,
     ...rest
   } = doc;
   const tempoChanges = normalizeTempoChanges(doc.tempo, rawTempoChanges, main.measures.length);
@@ -554,6 +570,8 @@ function closeWorkspace(doc) {
     tuning: [...main.tuning],
     measures: main.measures.map(storedMeasure)
   };
+  const memo = normalizeSongMemo(rawMemo);
+  if (memo !== void 0) out.memo = memo;
   const extras = bodies.slice(1).map(
     (b, i) => ({
       ...ws.metas[i + 1],
@@ -567,6 +585,7 @@ function closeWorkspace(doc) {
   if (extras.length > 0) out.tracks = extras;
   if (tempoChanges) out.tempoChanges = tempoChanges;
   let required = 1;
+  if (memo !== void 0) required = SONG_MEMO_FORMAT_REVISION;
   if (extras.length > 0) required = Math.max(required, MULTI_TRACK_FORMAT_REVISION);
   if (bodies.some((b) => measuresHaveHarmonics(b.measures))) {
     required = Math.max(required, HARMONICS_FORMAT_REVISION);
@@ -1021,7 +1040,7 @@ var state = {
   source: null
 };
 var server = new McpServer(
-  { name: "eztab", version: "0.5.1" },
+  { name: "eztab", version: "0.5.2" },
   {
     instructions: "All indices are 0-based: measure 0 is the first measure, string 0 is the top (highest) string, and column 0 is the first column. Notes and chords share the same column grid. Subdivisions are per beat and can differ within a measure (e.g. [2,2,3,2] mixes a triplet beat into straight eighths), so columns per measure = the sum of its per-beat subdivisions; get_tab's ruler shows the column indices. add_measures `at` is a 0-based insert position too. No need to ask the user about indexing. Exception: write_measures uses guitar string numbers (1 = top line), matching the labels get_tab prints. To write whole measures (e.g. transcribing a score or an image), prefer write_measures over set_cells \u2014 it takes one string per beat and does the column arithmetic for you. For transcribing from an image, follow the import_tab_from_image prompt. To deliver a result to the EZTab app, call send_to_eztab; to fix an existing tab, list_tabs \u2192 open_tab \u2192 edit \u2192 send_to_eztab. A tab can hold up to 4 tracks (parts, e.g. guitar + bass); track 0 is the main track. Tools that edit notes take an optional 0-based `track` (default 0). Measures and time signatures are shared by all tracks (adding/removing a measure affects every track); subdivisions are per track; chords belong to track 0 and use its columns."
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hidechae/eztab-mcp",
-  "version": "0.5.1",
-  "description": "MCP server for EZTab \u2014 lets an AI agent build and edit guitar/bass tablature.",
+  "version": "0.5.2",
+  "description": "MCP server for EZTab — lets an AI agent build and edit guitar/bass tablature.",
   "type": "module",
   "bin": {
     "eztab-mcp": "dist/server.js"