@hidechae/eztab-mcp 0.5.1 → 0.6.0

package/README.md

@@ -102,6 +102,7 @@ Run standalone for testing: `task mcp` (or `npx tsx mcp/server.ts`).
 | `add_measures` / `remove_measure` | Insert/remove measures (keys & sections re-anchored) |
 | `set_tuning` | Replace tuning / string count (`track` で対象パートを指定) |
 | `add_track` / `remove_track` | パート(ベース・2本目のギターなど)の追加・削除。メインを含めて最大4、track 0(メイン)は削除不可 |
+| `set_tone` | パートの再生音色を設定する(`track` で対象パートを指定)。`add_track` でも `tone` を指定できる |
 
 ### 複数パート(トラック)
 
@@ -113,10 +114,21 @@ 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.6.0では `7`)。
   対応上限を超える形式のタブは閲覧のみで、編集・送信できない。
   0.2.0以前のMCPは複数パートのタブを送り返せない(サーバが409で拒否する)。
 
+### パートの音色
+
+0.6.0以降はパートごとの再生音色(形式リビジョン7、docs/design/0010-track-tones.md)を扱えます。
+
+- 値は `clean`(既定)/ `crunch` / `distortion` / `acoustic` / `piano` / `synth` / `strings`
+- 値の意味はパートの楽器で変わる。名前かチューニングでベースと判定されるパートでは、
+  `crunch` はオーバードライブ、`acoustic` はウッドベース、`synth` はシンセベースとして鳴る
+- `get_tab` はクリーン以外の音色をパート一覧に `[distortion]` のように表示する
+  (1パートのタブでは `tone=distortion`)
+- 0.5.2以前のMCPは、クリーン以外の音色を持つタブを編集・送信できない
+
 ### 小節メモの保持
 
 0.5.1以降はアプリで入力した小節共通メモ(形式リビジョン5)を保持して編集・送信できます。
@@ -146,3 +158,5 @@ Claude Desktop では入力欄の「＋」→ eztab → `import_tab_from_image`
 EZTab のモデルに無い記譜(スライド・ハンマリング・プリング → タイ/スラー、
 ハーモニクス・ビブラート・装飾音 → 主音のみ等)の寄せ方は手順書
 ([prompts.ts](prompts.ts))に書いてあり、書き起こし後に簡略化した箇所を報告させる。
+
+0.5.2以降は曲全体のMarkdownメモ（形式リビジョン6）を既存の編集・送信操作で保持します。曲メモの入力・表示はwebアプリで行います。

package/dist/server.js

@@ -7,12 +7,26 @@ import { z } from "zod";
 
 // ../src/types/tab.ts
 var TAB_FILE_VERSION = 1;
-var SUPPORTED_FORMAT_REVISION = 5;
+var SUPPORTED_FORMAT_REVISION = 7;
+var SONG_MEMO_FORMAT_REVISION = 6;
 var MULTI_TRACK_FORMAT_REVISION = 2;
 var HARMONICS_FORMAT_REVISION = 3;
 var TEMPO_CHANGES_FORMAT_REVISION = 4;
 var MEASURE_MEMOS_FORMAT_REVISION = 5;
+var TONE_FORMAT_REVISION = 7;
 var MAX_TRACKS = 4;
+var TONES = [
+  "clean",
+  "crunch",
+  "distortion",
+  "acoustic",
+  "piano",
+  "synth",
+  "strings"
+];
+function normalizeTone(raw) {
+  return raw !== "clean" && TONES.includes(raw) ? raw : void 0;
+}
 var DEFAULT_MAIN_TRACK_NAME = "Guitar";
 var DEFAULT_TEMPO = 120;
 var MIN_TEMPO = 20;
@@ -252,10 +266,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 +306,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) {
@@ -306,12 +334,15 @@ function normalizeDocument(data) {
 }
 function normalizeTrackMeta(raw, fallbackName) {
   const volume = Number(raw?.volume);
-  return {
+  const meta = {
     id: typeof raw?.id === "string" && raw.id ? raw.id : newTabId(),
     name: typeof raw?.name === "string" && raw.name.trim() ? raw.name : fallbackName,
     volume: Number.isFinite(volume) ? Math.max(0, Math.min(1, volume)) : 1,
     muted: raw?.muted === true
   };
+  const tone = normalizeTone(raw?.tone);
+  if (tone) meta.tone = tone;
+  return meta;
 }
 function defaultMainTrack() {
   return { id: newTabId(), name: DEFAULT_MAIN_TRACK_NAME, volume: 1, muted: false };
@@ -536,7 +567,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 +577,7 @@ function closeWorkspace(doc) {
     tracks: _tr,
     formatRevision,
     tempoChanges: rawTempoChanges,
+    memo: rawMemo,
     ...rest
   } = doc;
   const tempoChanges = normalizeTempoChanges(doc.tempo, rawTempoChanges, main.measures.length);
@@ -554,6 +586,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],
@@ -562,16 +596,18 @@ function closeWorkspace(doc) {
     })
   );
   const mainMeta = ws.metas[0];
-  const mainIsDefault = mainMeta.name === DEFAULT_MAIN_TRACK_NAME && mainMeta.volume === 1 && !mainMeta.muted;
+  const mainIsDefault = mainMeta.name === DEFAULT_MAIN_TRACK_NAME && mainMeta.volume === 1 && !mainMeta.muted && !mainMeta.tone;
   if (extras.length > 0 || !mainIsDefault) out.mainTrack = mainMeta;
   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);
   }
   if (tempoChanges) required = Math.max(required, TEMPO_CHANGES_FORMAT_REVISION);
+  if (ws.metas.some((m) => m.tone)) required = Math.max(required, TONE_FORMAT_REVISION);
   if (out.measures.some((m) => m.memo !== void 0)) {
     required = Math.max(required, MEASURE_MEMOS_FORMAT_REVISION);
   }
@@ -672,6 +708,10 @@ function addTrack(doc, name, tuning) {
     }))
   };
   const meta = { id: newTabId(), name, volume: 1, muted: false };
+  return appendTrack(doc, meta, body);
+}
+function appendTrack(doc, meta, body) {
+  const ws = doc.workspace;
   const added = {
     ...doc,
     workspace: { ...ws, metas: [...ws.metas, meta], parked: [...ws.parked, body] }
@@ -688,6 +728,16 @@ function removeTrack(doc, index) {
   const active = w.active > index ? w.active - 1 : w.active;
   return { ...shown, workspace: { active, metas, parked } };
 }
+function setTrackTone(doc, index, tone) {
+  const ws = doc.workspace;
+  if (!ws || !ws.metas[index]) return doc;
+  const metas = ws.metas.map((m, i) => {
+    if (i !== index) return m;
+    const { tone: _tone, ...rest } = m;
+    return tone === "clean" ? rest : { ...rest, tone };
+  });
+  return { ...doc, workspace: { ...ws, metas } };
+}
 function storedSize(doc) {
   return new TextEncoder().encode(JSON.stringify(closeWorkspace(doc))).length;
 }
@@ -908,11 +958,13 @@ function render(doc, from = 0, to = doc.measures.length - 1, track) {
     lines.push(`Tracks (track index: name, tuning top\u2192bottom)   measures=${main.measures.length}`);
     metas.forEach((t, i) => {
       lines.push(
-        `  ${i}: ${t.name}  ${bodies[i].tuning.join(" ")}${i === 0 ? "  (main: carries the chords)" : ""}`
+        `  ${i}: ${t.name}${t.tone ? ` [${t.tone}]` : ""}  ${bodies[i].tuning.join(" ")}${i === 0 ? "  (main: carries the chords)" : ""}`
       );
     });
   } else {
-    lines.push(`Tuning (top\u2192bottom): ${main.tuning.join(" ")}   measures=${main.measures.length}`);
+    lines.push(
+      `Tuning (top\u2192bottom): ${main.tuning.join(" ")}   measures=${main.measures.length}${metas[0].tone ? `   tone=${metas[0].tone}` : ""}`
+    );
   }
   const ann = [];
   main.measures.forEach((_, m) => {
@@ -1021,7 +1073,7 @@ var state = {
   source: null
 };
 var server = new McpServer(
-  { name: "eztab", version: "0.5.1" },
+  { name: "eztab", version: "0.6.0" },
   {
     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."
   }
@@ -1510,6 +1562,21 @@ server.tool(
     doc.measures = doc.measures.map((m) => resizeMeasureStrings(m, a.tuning.length));
   }, a.track)
 );
+var toneParam = z.enum(TONES).describe(
+  "How the track sounds in playback. What a value means follows the track's instrument (a track named or tuned like a bass is a bass): clean; crunch = light overdrive (bass: overdrive); distortion; acoustic = acoustic guitar (bass: upright bass); piano; synth = synth lead (bass: synth bass); strings."
+);
+server.tool(
+  "set_tone",
+  "Set a track's playback tone (clean, crunch, distortion, acoustic, piano, synth, strings). Only the sound changes; the notes stay as written.",
+  { tone: toneParam, track: trackParam },
+  async (a) => {
+    const doc = edit(0, () => {
+    });
+    onTrack(doc, a.track);
+    state.doc = setTrackTone(doc, a.track ?? 0, a.tone);
+    return text(render(state.doc));
+  }
+);
 var TRACK_PRESETS = [
   "Guitar (6)",
   "Guitar (7)",
@@ -1524,17 +1591,19 @@ server.tool(
   {
     name: z.string().min(1).describe("Shown in the app, e.g. 'Bass' or 'Guitar 2'."),
     preset: z.enum(TRACK_PRESETS).optional(),
-    tuning: z.array(z.string()).min(1).optional().describe("Top (highest) to bottom; overrides preset.")
+    tuning: z.array(z.string()).min(1).optional().describe("Top (highest) to bottom; overrides preset."),
+    tone: toneParam.optional().describe("Playback tone (see set_tone); default clean.")
   },
   async (a) => {
     const before = trackMetas(requireDoc()).length;
     const tuning = a.tuning ?? PRESET_TUNINGS[a.preset ?? "Bass (4)"];
     const doc = edit(0, () => {
     });
-    const next = addTrack(doc, a.name, tuning);
-    if (trackMetas(next).length === before) {
+    const added = addTrack(doc, a.name, tuning);
+    if (trackMetas(added).length === before) {
       throw new Error("a tab can hold at most 4 tracks");
     }
+    const next = setTrackTone(added, before, a.tone ?? "clean");
     state.doc = next;
     return text(`Added track ${before} "${a.name}".
 

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.6.0",
+  "description": "MCP server for EZTab — lets an AI agent build and edit guitar/bass tablature.",
   "type": "module",
   "bin": {
     "eztab-mcp": "dist/server.js"