@shibbirweb/mcp-db-read-only 0.1.0 → 1.0.0

package/dist/server/McpDbServer.js

@@ -11,6 +11,8 @@ export class McpDbServer {
     tools;
     drivers;
     logger;
+    observer;
+    services;
     server;
     shuttingDown = false;
     /**
@@ -18,20 +20,31 @@ export class McpDbServer {
      * second place to remember at release time, and the one that silently wins
      * when it is forgotten. The composition root reads it from `package.json`.
      */
-    constructor(tools, drivers, logger, version, name = "db-readonly-switchable") {
+    constructor(tools, drivers, logger, observer, services, version, name = "db-readonly-switchable") {
         this.tools = tools;
         this.drivers = drivers;
         this.logger = logger;
+        this.observer = observer;
+        this.services = services;
         this.server = new McpServer({ name, version });
     }
+    /** The MCP client's name from its handshake, e.g. "claude-ai", or null before one. */
+    clientName() {
+        return this.server.server.getClientVersion()?.name ?? null;
+    }
     async start() {
         // Registered before the transport connects, so a tools/list arriving
         // immediately after the handshake can be answered.
         for (const tool of this.tools) {
-            tool.register(this.server);
+            tool.register(this.server, this.observer);
         }
         this.installSignalHandlers();
         await this.server.connect(new StdioServerTransport());
+        // After the transport, so a slow or failing helper cannot delay the
+        // handshake. Each one reports its own problems and never rejects.
+        for (const service of this.services) {
+            await service.start().catch((error) => this.logger(`background service failed to start: ${String(error)}`));
+        }
         // stderr, always. On stdio transport stdout carries JSON-RPC and a single
         // stray byte corrupts the stream.
         this.logger("MCP database server running (read-only, switchable connection)");
@@ -63,6 +76,7 @@ export class McpDbServer {
             return;
         }
         this.shuttingDown = true;
+        await Promise.all(this.services.map((service) => service.stop().catch(() => undefined)));
         await this.drivers.closeAll();
         process.exit(0);
     }

package/dist/tools/BaseTool.js

@@ -1,4 +1,5 @@
 import { ToolResponse } from "../formatting/ToolResponse.js";
+import { SilentObserver } from "../logging/ToolCallObserver.js";
 /**
  * Template Method base for every tool.
  *
@@ -13,8 +14,13 @@ export class BaseTool {
      * argument type from the schema it was given, which it cannot do for a
      * schema held in an abstract property. Every subclass declares its own
      * argument interface, so the type is recovered immediately below.
+     *
+     * The observer sees the call from outside `invoke`, so it receives the
+     * final result, error results included, and a tool cannot opt out of it
+     * any more than it can opt out of the error contract. When call logging is
+     * off it is a SilentObserver and adds nothing.
      */
-    register(server) {
+    register(server, observer = new SilentObserver()) {
         server.registerTool(this.name, {
             // Sent at the top level as well as inside the annotations: newer
             // clients read the top-level field, older ones only the annotation.
@@ -22,7 +28,7 @@ export class BaseTool {
             description: this.description,
             inputSchema: this.inputSchema,
             annotations: this.annotations,
-        }, (args) => this.invoke(args));
+        }, (args) => observer.observe(this.name, args, () => this.invoke(args)));
     }
     /**
      * The one place a thrown error becomes a tool error.

package/dist/tools/connection/CurrentConnectionTool.js

@@ -4,6 +4,7 @@ import { ToolResponse } from "../../formatting/ToolResponse.js";
 /** Reports the active connection, its engine and its database. */
 export class CurrentConnectionTool extends BaseTool {
     connections;
+    viewerStatus;
     name = "current_connection";
     description = "Show which database server, engine and database the read-only tools are currently pointed at";
     annotations = {
@@ -14,23 +15,31 @@ export class CurrentConnectionTool extends BaseTool {
         openWorldHint: true,
     };
     inputSchema = {};
-    constructor(connections) {
+    /**
+     * @param viewerStatus the live log viewer's state, when it is configured,
+     *   so "where are my logs?" has an answer in the chat itself.
+     */
+    constructor(connections, viewerStatus = () => null) {
         super();
         this.connections = connections;
+        this.viewerStatus = viewerStatus;
     }
     async execute() {
         const target = this.connections.getActiveTarget();
         // Reads the nullable accessor rather than the asserting one, so an
         // unconfigured server reports its state as ordinary output instead of an
         // error. Nothing has gone wrong; nothing has been chosen yet.
+        const viewer = this.viewerStatus();
+        const viewerLine = viewer ? [`Live log viewer: ${viewer}`] : [];
         if (!target) {
-            return ToolResponse.text("No active connection. Call connect or use_connection to set one.");
+            return ToolResponse.text(["No active connection. Call connect or use_connection to set one.", ...viewerLine].join("\n"));
         }
         // Rendering through describe() is what keeps the password out of output.
         return ToolResponse.text([
             `Active profile: ${this.connections.getActiveName()}`,
             `Engine: ${EngineCatalog.label(target.engine)}`,
             `Target: ${target.describe()}`,
+            ...viewerLine,
         ].join("\n"));
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shibbirweb/mcp-db-read-only",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "A read-only MCP server for MySQL, MariaDB, PostgreSQL, SQLite, SQL Server, ClickHouse, MongoDB, Redis and Elasticsearch, with connections switchable at runtime.",
   "license": "MIT",
   "author": "Md. Shibbir Ahmed <shibbirweb@gmail.com>",