@hidechae/eztab-mcp 0.6.0 → 0.7.0

package/README.md

@@ -103,6 +103,7 @@ Run standalone for testing: `task mcp` (or `npx tsx mcp/server.ts`).
 | `set_tuning` | Replace tuning / string count (`track` で対象パートを指定) |
 | `add_track` / `remove_track` | パート(ベース・2本目のギターなど)の追加・削除。メインを含めて最大4、track 0(メイン)は削除不可 |
 | `set_tone` | パートの再生音色を設定する(`track` で対象パートを指定)。`add_track` でも `tone` を指定できる |
+| `set_backing_style` | 伴奏(コード)の音を設定する: `pad`(既定)/ `guitar` / `piano` / `bass`(ルートのみ) |
 
 ### 複数パート(トラック)
 
@@ -125,10 +126,20 @@ Run standalone for testing: `task mcp` (or `npx tsx mcp/server.ts`).
 - 値は `clean`(既定)/ `crunch` / `distortion` / `acoustic` / `piano` / `synth` / `strings`
 - 値の意味はパートの楽器で変わる。名前かチューニングでベースと判定されるパートでは、
   `crunch` はオーバードライブ、`acoustic` はウッドベース、`synth` はシンセベースとして鳴る
+- ベースと判定されるパートに設定できるのは `clean` / `crunch` / `acoustic` / `synth` だけ(0.6.1以降。
+  それ以外は `set_tone` / `add_track` がエラーを返す)
 - `get_tab` はクリーン以外の音色をパート一覧に `[distortion]` のように表示する
   (1パートのタブでは `tone=distortion`)
 - 0.5.2以前のMCPは、クリーン以外の音色を持つタブを編集・送信できない
 
+### 伴奏の音
+
+0.7.0以降は伴奏(コード)の音(docs/design/0011-backing-styles.md)を `set_backing_style` で設定できます。
+
+- `pad`(既定。従来の音)/ `guitar` / `piano` / `bass`(コードの構成音を鳴らさず、ルートだけをベースで弾く。分数コードは分母の音)
+- `get_tab` はパッド以外のとき、先頭行に `backing=guitar` のように表示する
+- 形式リビジョンは変わらない。0.6.1以前のMCPでも、設定されたタブを編集・送信でき、値は保持される
+
 ### 小節メモの保持
 
 0.5.1以降はアプリで入力した小節共通メモ(形式リビジョン5)を保持して編集・送信できます。

package/dist/server.js

@@ -28,6 +28,15 @@ function normalizeTone(raw) {
   return raw !== "clean" && TONES.includes(raw) ? raw : void 0;
 }
 var DEFAULT_MAIN_TRACK_NAME = "Guitar";
+var BACKING_STYLES = ["pad", "guitar", "piano", "bass"];
+function normalizeBackingStyle(raw) {
+  return raw !== "pad" && BACKING_STYLES.includes(raw) ? raw : void 0;
+}
+function withBackingStyle(doc, style) {
+  const { backingStyle: _old, ...rest } = doc;
+  const stored = normalizeBackingStyle(style);
+  return stored ? { ...rest, backingStyle: stored } : rest;
+}
 var DEFAULT_TEMPO = 120;
 var MIN_TEMPO = 20;
 var MAX_TEMPO = 400;
@@ -328,6 +337,9 @@ function normalizeDocument(data) {
   if (!data.mix || typeof data.mix.melody !== "number") {
     data.mix = { ...DEFAULT_MIX };
   }
+  const backingStyle = normalizeBackingStyle(data.backingStyle);
+  if (backingStyle) data.backingStyle = backingStyle;
+  else delete data.backingStyle;
   normalizeTracks(data);
   data.version = TAB_FILE_VERSION;
   return data;
@@ -503,6 +515,31 @@ function setBeatSubdivision(measure, beat, subdivision) {
   return remapToSubdivisions(measure, subs);
 }
 
+// ../src/lib/music.ts
+var LETTER_PC = {
+  C: 0,
+  D: 2,
+  E: 4,
+  F: 5,
+  G: 7,
+  A: 9,
+  B: 11
+};
+function noteToMidi(note) {
+  const m = /^([A-Ga-g])([#♯b♭]*)(-?\d+)?$/.exec(note.trim());
+  if (!m) return null;
+  let pc = LETTER_PC[m[1].toUpperCase()];
+  for (const ch of m[2]) {
+    if (ch === "#" || ch === "\u266F") pc += 1;
+    if (ch === "b" || ch === "\u266D") pc -= 1;
+  }
+  const octave = m[3] != null ? parseInt(m[3], 10) : 4;
+  return (octave + 1) * 12 + pc;
+}
+
+// ../src/lib/playbackRate.ts
+var PLAYBACK_RATES = Array.from({ length: 36 }, (_, i) => (5 + i) / 20);
+
 // ../src/lib/tracks.ts
 function newUid() {
   return newTabId();
@@ -742,6 +779,128 @@ function storedSize(doc) {
   return new TextEncoder().encode(JSON.stringify(closeWorkspace(doc))).length;
 }
 
+// ../src/lib/player.ts
+function instrumentOf(tuning, name = "") {
+  if (/bass|ベース/i.test(name)) return "bass";
+  const open = tuning.map(noteToMidi).filter((m) => m != null);
+  return open.length > 0 && Math.max(...open) < 50 ? "bass" : "guitar";
+}
+var BUFFER_BUDGET = 12e6;
+var PREPARE_CAPACITY = BUFFER_BUDGET / 2;
+var OPEN = 2e4;
+var GUITAR_CLEAN = {
+  pickupHz: 4500,
+  pickupQ: 4,
+  tightHz: 20,
+  pushDb: 0,
+  drive: 1,
+  stage1: null,
+  drive2: 1,
+  stage2: null,
+  interHpHz: 20,
+  interLpHz: OPEN,
+  bodyHz: 110,
+  bodyDb: 0,
+  cabHz: OPEN,
+  cabQ: 0,
+  lowCutHz: 70,
+  level: 1
+};
+var BASS_CLEAN = { ...GUITAR_CLEAN, pickupHz: 2600, pickupQ: 1, lowCutHz: 30 };
+var DIRECT = { ...GUITAR_CLEAN, pickupHz: 16e3, pickupQ: 0, lowCutHz: 30 };
+var PIANO = { ...DIRECT, pickupHz: 7e3, bodyHz: 220, bodyDb: 3, level: 1.3 };
+var CRUNCH = { gain: 16, bias: 0.3 };
+var CHAINS = {
+  guitar: {
+    clean: GUITAR_CLEAN,
+    crunch: {
+      ...GUITAR_CLEAN,
+      tightHz: 120,
+      pushDb: 2,
+      drive: 0.5,
+      stage1: CRUNCH,
+      bodyHz: 2800,
+      bodyDb: 2,
+      cabHz: 5200,
+      cabQ: 1,
+      lowCutHz: 80,
+      level: 0.26
+    },
+    distortion: {
+      ...GUITAR_CLEAN,
+      pickupQ: 2,
+      tightHz: 250,
+      pushDb: 6,
+      drive: 0.5,
+      stage1: { gain: 24, bias: 0.25 },
+      // The next tube stage is inverted, so it clips the other half harder.
+      drive2: 1,
+      stage2: { gain: 5, bias: -0.35 },
+      interHpHz: 160,
+      interLpHz: 6500,
+      bodyHz: 2800,
+      bodyDb: 4,
+      cabHz: 4800,
+      cabQ: 3,
+      lowCutHz: 90,
+      level: 0.17
+    },
+    acoustic: { ...GUITAR_CLEAN, pickupHz: 9e3, pickupQ: 0, bodyDb: 5, level: 1.2 },
+    piano: PIANO,
+    synth: { ...DIRECT, level: 0.8 },
+    strings: { ...DIRECT, level: 0.8 }
+  },
+  bass: {
+    clean: BASS_CLEAN,
+    // Overdrive.
+    crunch: {
+      ...BASS_CLEAN,
+      tightHz: 40,
+      pushDb: 3,
+      drive: 0.5,
+      stage1: { gain: 22, bias: 0.3 },
+      cabHz: 3500,
+      cabQ: 1,
+      level: 0.24
+    },
+    // The mixer offers a bass only the tones in tonesFor(); these three still
+    // play if a tab stores them (a guitar track retuned to a bass, say).
+    distortion: {
+      ...BASS_CLEAN,
+      tightHz: 60,
+      pushDb: 4,
+      drive: 0.5,
+      stage1: { gain: 24, bias: 0.25 },
+      stage2: { gain: 5, bias: -0.35 },
+      interHpHz: 50,
+      interLpHz: 5e3,
+      cabHz: 3e3,
+      cabQ: 2,
+      lowCutHz: 35,
+      level: 0.15
+    },
+    // Upright bass.
+    acoustic: {
+      ...BASS_CLEAN,
+      pickupHz: 3e3,
+      pickupQ: 0,
+      bodyHz: 100,
+      bodyDb: 6,
+      level: 1.4
+    },
+    piano: PIANO,
+    // Synth bass.
+    synth: { ...DIRECT, level: 0.8 },
+    strings: { ...DIRECT, level: 0.8 }
+  }
+};
+
+// ../src/lib/tones.ts
+var BASS_TONES = ["clean", "crunch", "acoustic", "synth"];
+function tonesFor(instrument) {
+  return instrument === "bass" ? BASS_TONES : TONES;
+}
+
 // ../src/lib/config.ts
 var CLOUD_BASE_URL = "https://eztab-sync-736328841982.asia-northeast1.run.app";
 
@@ -953,7 +1112,9 @@ function render(doc, from = 0, to = doc.measures.length - 1, track) {
   const main = bodies[0];
   const shown = bodies.map((_, i) => i).filter((i) => track == null || i === track);
   const lines = [];
-  lines.push(`Title: ${doc.title}${doc.artist ? ` \u2014 ${doc.artist}` : ""}   tempo=${doc.tempo}`);
+  lines.push(
+    `Title: ${doc.title}${doc.artist ? ` \u2014 ${doc.artist}` : ""}   tempo=${doc.tempo}${doc.backingStyle ? `   backing=${doc.backingStyle}` : ""}`
+  );
   if (multi) {
     lines.push(`Tracks (track index: name, tuning top\u2192bottom)   measures=${main.measures.length}`);
     metas.forEach((t, i) => {
@@ -1073,7 +1234,7 @@ var state = {
   source: null
 };
 var server = new McpServer(
-  { name: "eztab", version: "0.6.0" },
+  { name: "eztab", version: "0.7.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."
   }
@@ -1563,17 +1724,38 @@ server.tool(
   }, 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."
+  "How the track sounds in playback. Guitar tracks: clean, crunch (light overdrive), distortion, acoustic, piano, synth, strings. Bass tracks (named or tuned like a bass): clean, crunch (overdrive), acoustic (upright bass), synth (synth bass) only."
 );
+function withTone(doc, track, tone) {
+  const instrument = instrumentOf(trackBodies(doc)[track].tuning, trackMetas(doc)[track].name);
+  const offered = tonesFor(instrument);
+  if (!offered.includes(tone)) {
+    throw new Error(
+      `a ${instrument} track can't use the "${tone}" tone; choose one of: ${offered.join(", ")}`
+    );
+  }
+  return setTrackTone(doc, track, tone);
+}
 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.",
+  "Set a track's playback tone. 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);
+    state.doc = withTone(doc, a.track ?? 0, a.tone);
+    return text(render(state.doc));
+  }
+);
+server.tool(
+  "set_backing_style",
+  "Set how the chord backing (the chords written with set_chords / @Name) sounds in playback: pad (the default soft pad), guitar, piano, or bass (only the root \u2014 or a slash chord's bass note \u2014 on a bass).",
+  { style: z.enum(BACKING_STYLES) },
+  async (a) => {
+    const doc = edit(0, () => {
+    });
+    state.doc = withBackingStyle(doc, a.style);
     return text(render(state.doc));
   }
 );
@@ -1603,7 +1785,7 @@ server.tool(
     if (trackMetas(added).length === before) {
       throw new Error("a tab can hold at most 4 tracks");
     }
-    const next = setTrackTone(added, before, a.tone ?? "clean");
+    const next = withTone(added, before, a.tone ?? "clean");
     state.doc = next;
     return text(`Added track ${before} "${a.name}".
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hidechae/eztab-mcp",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "MCP server for EZTab — lets an AI agent build and edit guitar/bass tablature.",
   "type": "module",
   "bin": {