db-mcp 2.0.0 → 3.0.1

package/test-server/scripts/test-help-resources.mjs

@@ -1,245 +0,0 @@
-/**
- * Integration Test: Help Resources + Slim Instructions
- *
- * Starts the server with various --tool-filter configs and verifies:
- * 1. Instructions are slim (~680 chars, within client limits)
- * 2. sqlite://help resources are registered based on tool filter
- * 3. Group-specific help resources are only registered for enabled groups
- *
- * Usage:
- *   npm run build
- *   node test-server/scripts/test-help-resources.mjs
- */
-
-import { spawn } from "child_process";
-
-const PROJECT_DIR = "C:\\Users\\chris\\Desktop\\db-mcp";
-
-/**
- * Start server, send initialize + resources/list, return results
- */
-function testServer(args) {
-  return new Promise((resolve, reject) => {
-    const proc = spawn("node", ["dist/cli.js", ...args], {
-      cwd: PROJECT_DIR,
-      stdio: ["pipe", "pipe", "pipe"],
-    });
-
-    let buffer = "";
-    let instructions = "";
-    let resourceUris = [];
-    let gotInitialize = false;
-
-    proc.stdout.on("data", (chunk) => {
-      buffer += chunk.toString();
-      const lines = buffer.split("\n");
-      buffer = lines.pop(); // Keep incomplete line
-
-      for (const line of lines) {
-        const trimmed = line.trim();
-        if (!trimmed) continue;
-        try {
-          const msg = JSON.parse(trimmed);
-
-          // Response to initialize (id=1)
-          if (msg.id === 1 && msg.result) {
-            instructions =
-              msg.result?.serverInfo?.instructions ||
-              msg.result?.instructions ||
-              msg.result?.capabilities?.instructions ||
-              "";
-            gotInitialize = true;
-
-            // Send resources/list
-            proc.stdin.write(
-              JSON.stringify({
-                jsonrpc: "2.0",
-                id: 2,
-                method: "resources/list",
-                params: {},
-              }) + "\n",
-            );
-          }
-
-          // Response to resources/list (id=2)
-          if (msg.id === 2 && msg.result) {
-            const resources = msg.result.resources || [];
-            resourceUris = resources.map((r) => r.uri);
-            proc.kill();
-            resolve({
-              instructions,
-              instructionChars: instructions.length,
-              resourceUris,
-            });
-          }
-        } catch {
-          // Not complete JSON yet
-        }
-      }
-    });
-
-    proc.stderr.on("data", () => {});
-
-    // Send initialize request
-    proc.stdin.write(
-      JSON.stringify({
-        jsonrpc: "2.0",
-        id: 1,
-        method: "initialize",
-        params: {
-          protocolVersion: "2025-03-26",
-          capabilities: {},
-          clientInfo: { name: "help-resource-test", version: "1.0" },
-        },
-      }) + "\n",
-    );
-
-    setTimeout(() => {
-      proc.kill();
-      reject(new Error(`Timeout for args: ${args.join(" ")}`));
-    }, 10000);
-  });
-}
-
-async function main() {
-  let allPassed = true;
-
-  // ── Test 1: Slim Instructions ──
-  console.log("=== Test 1: Slim Instructions ===\n");
-
-  const baseResult = await testServer([]);
-  console.log(`  Instruction chars: ${baseResult.instructionChars}`);
-  console.log(
-    `  Token estimate: ~${Math.round(baseResult.instructionChars / 4)}`,
-  );
-
-  const isSlim = baseResult.instructionChars < 1000;
-  console.log(`  Under 1000 chars: ${isSlim ? "✅" : "❌"}`);
-  if (!isSlim) allPassed = false;
-
-  const hasHelpPointer = baseResult.instructions.includes("sqlite://help");
-  console.log(
-    `  Contains sqlite://help pointer: ${hasHelpPointer ? "✅" : "❌"}`,
-  );
-  if (!hasHelpPointer) allPassed = false;
-
-  const noOldContent = !baseResult.instructions.includes("Critical Gotchas");
-  console.log(
-    `  No old gotchas in instructions: ${noOldContent ? "✅" : "❌"}`,
-  );
-  if (!noOldContent) allPassed = false;
-
-  // ── Test 2: Core-only Filter ──
-  console.log("\n=== Test 2: Core-only Filter (--tool-filter core) ===\n");
-
-  const coreResult = await testServer(["--tool-filter", "core"]);
-  const coreHelpUris = coreResult.resourceUris.filter((u) =>
-    u.startsWith("sqlite://help"),
-  );
-  console.log(`  Help resources: ${coreHelpUris.join(", ") || "(none)"}`);
-
-  const coreHasBaseHelp = coreHelpUris.includes("sqlite://help");
-  console.log(`  Has sqlite://help: ${coreHasBaseHelp ? "✅" : "❌"}`);
-  if (!coreHasBaseHelp) allPassed = false;
-
-  const coreHasCoreHelp = coreHelpUris.includes("sqlite://help/core");
-  console.log(`  Has sqlite://help/core: ${coreHasCoreHelp ? "✅" : "❌"}`);
-  if (!coreHasCoreHelp) allPassed = false;
-
-  const coreNoOtherGroupHelp = coreHelpUris.length === 2;
-  console.log(
-    `  No other group-specific help: ${coreNoOtherGroupHelp ? "✅" : "❌"} (count: ${coreHelpUris.length})`,
-  );
-  if (!coreNoOtherGroupHelp) allPassed = false;
-
-  // ── Test 3: Stats Filter ──
-  console.log("\n=== Test 3: Stats Filter (--tool-filter stats) ===\n");
-
-  const statsResult = await testServer(["--tool-filter", "stats"]);
-  const statsHelpUris = statsResult.resourceUris.filter((u) =>
-    u.startsWith("sqlite://help"),
-  );
-  console.log(`  Help resources: ${statsHelpUris.join(", ")}`);
-
-  const statsHasBaseHelp = statsHelpUris.includes("sqlite://help");
-  const statsHasStatsHelp = statsHelpUris.includes("sqlite://help/stats");
-  console.log(`  Has sqlite://help: ${statsHasBaseHelp ? "✅" : "❌"}`);
-  console.log(`  Has sqlite://help/stats: ${statsHasStatsHelp ? "✅" : "❌"}`);
-  if (!statsHasBaseHelp || !statsHasStatsHelp) allPassed = false;
-
-  const statsNoJsonHelp = !statsHelpUris.includes("sqlite://help/json");
-  console.log(`  No sqlite://help/json: ${statsNoJsonHelp ? "✅" : "❌"}`);
-  if (!statsNoJsonHelp) allPassed = false;
-
-  // ── Test 4: Multi-group Filter ──
-  console.log(
-    "\n=== Test 4: Multi-group Filter (--tool-filter core,json,text,stats) ===\n",
-  );
-
-  const multiResult = await testServer([
-    "--tool-filter",
-    "core,json,text,stats",
-  ]);
-  const multiHelpUris = multiResult.resourceUris.filter((u) =>
-    u.startsWith("sqlite://help"),
-  );
-  console.log(`  Help resources: ${multiHelpUris.join(", ")}`);
-
-  const expectedMulti = [
-    "sqlite://help",
-    "sqlite://help/core",
-    "sqlite://help/json",
-    "sqlite://help/text",
-    "sqlite://help/stats",
-  ];
-  for (const uri of expectedMulti) {
-    const found = multiHelpUris.includes(uri);
-    console.log(`  Has ${uri}: ${found ? "✅" : "❌"}`);
-    if (!found) allPassed = false;
-  }
-
-  const multiNoVector = !multiHelpUris.includes("sqlite://help/vector");
-  const multiNoGeo = !multiHelpUris.includes("sqlite://help/geo");
-  console.log(`  No sqlite://help/vector: ${multiNoVector ? "✅" : "❌"}`);
-  console.log(`  No sqlite://help/geo: ${multiNoGeo ? "✅" : "❌"}`);
-  if (!multiNoVector || !multiNoGeo) allPassed = false;
-
-  // ── Test 5: Full Filter ──
-  console.log("\n=== Test 5: Full Filter (--tool-filter full) ===\n");
-
-  const fullResult = await testServer(["--tool-filter", "full"]);
-  const fullHelpUris = fullResult.resourceUris.filter((u) =>
-    u.startsWith("sqlite://help"),
-  );
-  console.log(
-    `  Help resources (${fullHelpUris.length}): ${fullHelpUris.join(", ")}`,
-  );
-
-  const expectedFull = [
-    "sqlite://help",
-    "sqlite://help/core",
-    "sqlite://help/json",
-    "sqlite://help/text",
-    "sqlite://help/stats",
-    "sqlite://help/vector",
-    "sqlite://help/geo",
-    "sqlite://help/admin",
-    "sqlite://help/transactions",
-    "sqlite://help/introspection",
-    "sqlite://help/migration",
-  ];
-  const fullHasAll = expectedFull.every((u) => fullHelpUris.includes(u));
-  console.log(`  Has all 11 help resources: ${fullHasAll ? "✅" : "❌"}`);
-  if (!fullHasAll) allPassed = false;
-
-  // ── Summary ──
-  console.log(
-    `\n=== Overall: ${allPassed ? "✅ ALL PASSED" : "❌ FAILURES"} ===`,
-  );
-  process.exit(allPassed ? 0 : 1);
-}
-
-main().catch((err) => {
-  console.error("Fatal:", err.message);
-  process.exit(1);
-});

package/test-server/scripts/test-prompts.mjs

@@ -1,251 +0,0 @@
-import { spawn } from "child_process";
-import { resolve, dirname } from "path";
-import { fileURLToPath } from "url";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const projectDir = resolve(__dirname, "../..");
-
-const proc = spawn(
-  "node",
-  [
-    "dist/cli.js",
-    "--sqlite-native",
-    "./test-server/test.db",
-    "--log-level",
-    "error",
-  ],
-  {
-    cwd: projectDir,
-    stdio: ["pipe", "pipe", "pipe"],
-  },
-);
-
-let buffer = "";
-const pending = new Map(); // id -> resolve
-
-proc.stdout.on("data", (chunk) => {
-  buffer += chunk.toString();
-  const lines = buffer.split("\n");
-  buffer = lines.pop(); // keep incomplete
-  for (const line of lines) {
-    const trimmed = line.trim();
-    if (!trimmed) continue;
-    try {
-      const msg = JSON.parse(trimmed);
-      if (msg.id && pending.has(msg.id)) {
-        pending.get(msg.id)(msg);
-        pending.delete(msg.id);
-      }
-    } catch {}
-  }
-});
-proc.stderr.on("data", () => {});
-
-let nextId = 1;
-function rpc(method, params = {}) {
-  const id = nextId++;
-  return new Promise((resolve, reject) => {
-    const timer = setTimeout(() => {
-      pending.delete(id);
-      reject(new Error(`Timeout: ${method}`));
-    }, 20000);
-    pending.set(id, (msg) => {
-      clearTimeout(timer);
-      resolve(msg);
-    });
-    proc.stdin.write(
-      JSON.stringify({ jsonrpc: "2.0", id, method, params }) + "\n",
-    );
-  });
-}
-function notify(method, params = {}) {
-  proc.stdin.write(JSON.stringify({ jsonrpc: "2.0", method, params }) + "\n");
-}
-
-const delay = (ms) => new Promise((r) => setTimeout(r, ms));
-
-async function main() {
-  // Initialize
-  await rpc("initialize", {
-    protocolVersion: "2025-03-26",
-    capabilities: {},
-    clientInfo: { name: "test-prompts", version: "1.0" },
-  });
-  await delay(500);
-  notify("notifications/initialized");
-  await delay(1000);
-
-  // List prompts
-  const listResp = await rpc("prompts/list", {});
-  const prompts = listResp.result?.prompts ?? [];
-  console.log(`\n=== PROMPTS LIST: ${prompts.length} prompts ===`);
-  for (const p of prompts) {
-    const args = (p.arguments || [])
-      .map((a) => `${a.name}${a.required ? "*" : ""}`)
-      .join(", ");
-    console.log(`  ${p.name}(${args})`);
-  }
-
-  const testCases = [
-    // No-argument prompts
-    { name: "sqlite_explain_schema", args: {}, expect: "" },
-    { name: "sqlite_optimization", args: {}, expect: "" },
-    { name: "sqlite_documentation", args: {}, expect: "" },
-
-    // Required-argument prompts
-    {
-      name: "sqlite_query_builder",
-      args: {
-        operation: "SELECT",
-        tables: "users",
-        description: "find active",
-      },
-      expect: "",
-    },
-    {
-      name: "sqlite_data_analysis",
-      args: { table: "users" },
-      expect: "",
-    },
-    {
-      name: "sqlite_migration",
-      args: { change: "add desc" },
-      expect: "",
-    },
-    {
-      name: "sqlite_debug_query",
-      args: { query: "SELECT * FROM test" },
-      expect: "",
-    },
-    {
-      name: "sqlite_summarize_table",
-      args: { table_name: "users" },
-      expect: "",
-    },
-    {
-      name: "sqlite_hybrid_search_workflow",
-      args: { use_case: "product_search" },
-      expect: "",
-    },
-    {
-      name: "sqlite_demo",
-      args: { topic: "sales" },
-      expect: "",
-    },
-
-    // Optional-argument prompts
-    {
-      name: "sqlite_data_analysis",
-      args: { table: "users", focus: "growth" },
-      expect: "",
-    },
-    {
-      name: "sqlite_migration",
-      args: { change: "add id", reversible: "true" },
-      expect: "",
-    },
-  ];
-
-  console.log(`\n=== TESTING ${testCases.length} PROMPT CALLS ===\n`);
-  let pass = 0,
-    fail = 0;
-
-  for (const tc of testCases) {
-    const argsStr = Object.keys(tc.args).length
-      ? JSON.stringify(tc.args)
-      : "(none)";
-    try {
-      const resp = await rpc("prompts/get", {
-        name: tc.name,
-        arguments: tc.args,
-      });
-      if (resp.error) {
-        console.log(
-          `FAIL ${tc.name}(${argsStr}): MCP error: ${JSON.stringify(resp.error)}`,
-        );
-        fail++;
-        continue;
-      }
-      const messages = resp.result?.messages;
-      const checks = [];
-      if (!Array.isArray(messages)) checks.push("messages not array");
-      else if (messages.length < 1) checks.push("messages empty");
-      else {
-        const m = messages[0];
-        if (m.role !== "user") checks.push(`role=${m.role}`);
-        if (!m.content) checks.push("no content");
-        else {
-          const c = m.content;
-          if (c.type !== "text") checks.push(`type=${c.type}`);
-          if (!c.text || c.text.length === 0) checks.push("text empty");
-          else if (
-            tc.expect &&
-            !c.text.toLowerCase().includes(tc.expect.toLowerCase())
-          ) {
-            checks.push(`missing '${tc.expect}' (len=${c.text.length})`);
-          }
-        }
-      }
-      if (checks.length === 0) {
-        const textLen = messages?.[0]?.content?.text?.length ?? 0;
-        console.log(
-          `PASS ${tc.name}(${argsStr}) — msgs:${messages.length}, textLen:${textLen}`,
-        );
-        pass++;
-      } else {
-        console.log(`FAIL ${tc.name}(${argsStr}): ${checks.join("; ")}`);
-        fail++;
-      }
-    } catch (err) {
-      console.log(`FAIL ${tc.name}(${argsStr}): ${err.message}`);
-      fail++;
-    }
-  }
-
-  // Error handling tests
-  try {
-    const resp = await rpc("prompts/get", {
-      name: "nonexistent-prompt",
-      arguments: {},
-    });
-    if (resp.error) {
-      console.log(
-        `PASS nonexistent-prompt: MCP error (code=${resp.error.code})`,
-      );
-      pass++;
-    } else {
-      console.log(`FAIL nonexistent-prompt: expected error`);
-      fail++;
-    }
-  } catch (err) {
-    console.log(`FAIL nonexistent-prompt: ${err.message}`);
-    fail++;
-  }
-
-  try {
-    const resp = await rpc("prompts/get", {
-      name: "sqlite_query_builder",
-      arguments: {},
-    });
-    if (resp.error) {
-      console.log(`PASS sqlite_query_builder(no args): error returned`);
-    } else {
-      console.log(`PASS sqlite_query_builder(no args): handled gracefully`);
-    }
-    pass++;
-  } catch (err) {
-    console.log(`FAIL sqlite_query_builder(no args): ${err.message}`);
-    fail++;
-  }
-
-  console.log(
-    `\n=== RESULTS: ${pass} pass, ${fail} fail (${pass + fail} total) ===`,
-  );
-  proc.kill();
-  process.exit(fail > 0 ? 1 : 0);
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/test-server/scripts/test-tool-annotations.mjs

@@ -1,162 +0,0 @@
-/**
- * Integration Test: Tool Annotations
- *
- * Verifies that all tools returned by tools/list have annotations
- * with openWorldHint set. db-mcp tools are all local SQLite operations,
- * so all should have openWorldHint: false.
- *
- * Usage:
- *   npm run build
- *   node test-server/scripts/test-tool-annotations.mjs
- */
-
-import { spawn } from "child_process";
-
-const projectDir = "C:\\Users\\chris\\Desktop\\db-mcp";
-const proc = spawn(
-  "node",
-  [
-    "dist/cli.js",
-    "--instruction-level",
-    "essential",
-    "--sqlite-native",
-    "./test-server/test.db",
-    "--tool-filter",
-    "+all",
-  ],
-  {
-    cwd: projectDir,
-    stdio: ["pipe", "pipe", "pipe"],
-  },
-);
-
-let buffer = "";
-let finished = false;
-
-proc.stdout.on("data", (chunk) => {
-  buffer += chunk.toString();
-
-  // Try to parse complete JSON-RPC responses
-  const lines = buffer.split("\n");
-  for (const line of lines) {
-    const trimmed = line.trim();
-    if (!trimmed) continue;
-    try {
-      const msg = JSON.parse(trimmed);
-      if (msg.id === 1) {
-        // Initialize response — skip
-      } else if (msg.id === 2) {
-        // tools/list response
-        const tools = msg.result?.tools || [];
-        console.log(`Total tools: ${tools.length}`);
-
-        let withAnnotations = 0;
-        let openWorldTrue = 0;
-        let openWorldFalse = 0;
-        let missing = 0;
-        const trueNames = [];
-        const missingNames = [];
-
-        for (const tool of tools) {
-          if (tool.annotations) {
-            withAnnotations++;
-            if (tool.annotations.openWorldHint === true) {
-              openWorldTrue++;
-              trueNames.push(tool.name);
-            } else if (tool.annotations.openWorldHint === false) {
-              openWorldFalse++;
-            } else {
-              missing++;
-              missingNames.push(tool.name);
-            }
-          } else {
-            missing++;
-            missingNames.push(tool.name);
-          }
-        }
-
-        console.log(
-          `Tools with annotations: ${withAnnotations}/${tools.length}`,
-        );
-        console.log(`openWorldHint=false (local): ${openWorldFalse}`);
-        console.log(`openWorldHint=true: ${openWorldTrue}`);
-        console.log(`Missing openWorldHint: ${missing}`);
-
-        if (trueNames.length > 0) {
-          console.log(`\nopenWorldHint=true tools: ${trueNames.join(", ")}`);
-        }
-        if (missingNames.length > 0) {
-          console.log(`\nMISSING annotations: ${missingNames.join(", ")}`);
-        }
-
-        // Verification
-        const expectedCount = 154; // 151 Native tools + 3 built-in tools
-        const hasExpectedCount = tools.length === expectedCount;
-        const allHaveAnnotations = missing === 0;
-        const allAreFalse =
-          openWorldTrue === 0 && openWorldFalse === tools.length;
-
-        console.log(
-          `\n  Has exactly ${expectedCount} tools: ${hasExpectedCount ? "✅" : "❌"} (actual: ${tools.length})`,
-        );
-        console.log(
-          `  All tools have annotations: ${allHaveAnnotations ? "✅" : "❌"}`,
-        );
-        console.log(
-          `  All openWorldHint=false: ${allAreFalse ? "✅" : "⚠️ (some are true)"}`,
-        );
-
-        finished = true;
-        proc.kill();
-        process.exit(allHaveAnnotations && hasExpectedCount ? 0 : 1);
-      }
-    } catch {
-      // Not complete JSON yet
-    }
-  }
-});
-
-proc.stderr.on("data", () => {});
-
-// Send initialize
-proc.stdin.write(
-  JSON.stringify({
-    jsonrpc: "2.0",
-    id: 1,
-    method: "initialize",
-    params: {
-      protocolVersion: "2025-03-26",
-      capabilities: {},
-      clientInfo: { name: "test", version: "1.0" },
-    },
-  }) + "\n",
-);
-
-// Wait, then send initialized + tools/list
-setTimeout(() => {
-  proc.stdin.write(
-    JSON.stringify({
-      jsonrpc: "2.0",
-      method: "notifications/initialized",
-    }) + "\n",
-  );
-
-  setTimeout(() => {
-    proc.stdin.write(
-      JSON.stringify({
-        jsonrpc: "2.0",
-        id: 2,
-        method: "tools/list",
-        params: {},
-      }) + "\n",
-    );
-  }, 500);
-}, 1500);
-
-setTimeout(() => {
-  if (!finished) {
-    console.log("Timeout — killing process");
-    proc.kill();
-    process.exit(1);
-  }
-}, 15000);