thingd-cli 0.2.0 → 0.3.0

package/README.md

@@ -77,6 +77,38 @@ You can configure the connection via environment variables or CLI flags:
 --limit <n>          result limit for search and list commands
 ```
 
+### Claude Desktop & MCP Integration
+
+The `thingd` CLI has a built-in `mcp` subcommand that exposes an MCP server over `stdio`. This allows Claude Desktop to securely connect to your `thingd` database.
+
+**Connecting to a Local Database:**
+To let Claude read and write to a local `thingd.db` file, add this to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "thingd-local": {
+      "command": "thingd",
+      "args": ["mcp", "--path", "/absolute/path/to/thingd.db", "--driver", "native"]
+    }
+  }
+}
+```
+
+**Bridging Claude to the Cloud:**
+Claude Desktop natively only supports local `stdio` servers. However, `thingd mcp` can act as a bridge! If you provide a `--url`, the CLI will launch locally but seamlessly proxy all of Claude's requests to your remote cluster:
+
+```json
+{
+  "mcpServers": {
+    "thingd-cloud": {
+      "command": "thingd",
+      "args": ["mcp", "--url", "https://your-thingd-cloud.com/mcp", "--auth-token", "your-secret-token"]
+    }
+  }
+}
+```
+
 ### Command Reference
 
 **Metrics & Discovery**

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { ThingD, type ThingDDriver } from "thingd";
 type CliEnv = Record<string, string | undefined>;
 type WritableLike = {
     write(chunk: string): void;
@@ -8,6 +9,26 @@ export type RunCliOptions = {
     stdout?: WritableLike;
     stderr?: WritableLike;
 };
+type ParsedArgs = {
+    tokens: string[];
+    flags: Map<string, string[]>;
+    booleans: Set<string>;
+};
+export type CliContext = {
+    parsed: ParsedArgs;
+    env: CliEnv;
+    stdout: WritableLike;
+    stderr: WritableLike;
+    pretty: boolean;
+};
+export type ConnectionOptions = {
+    path: string;
+    driver?: ThingDDriver;
+    authToken?: string;
+    cloud: boolean;
+};
 export declare function runCli(args?: string[], options?: RunCliOptions): Promise<number>;
+export declare function withDb(context: CliContext, callback: (db: ThingD) => Promise<void>): Promise<void>;
+export declare function resolveConnection(context: CliContext): ConnectionOptions;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAiBA,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjD,KAAK,YAAY,GAAG;IAClB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AA4DF,wBAAsB,MAAM,CAC1B,IAAI,WAAwB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAiCjB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAKA,OAAO,EAOL,MAAM,EACN,KAAK,YAAY,EAClB,MAAM,QAAQ,CAAC;AAIhB,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjD,KAAK,YAAY,GAAG;IAClB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAuCF,wBAAsB,MAAM,CAC1B,IAAI,WAAwB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAmUD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAcf;AA4BD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,iBAAiB,CAYxE"}

package/dist/index.js

@@ -4,6 +4,7 @@ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
 import { ThingD, } from "thingd";
 import { runInteractiveCli } from "./interactive.js";
+import { runMcp } from "./mcp.js";
 const HELP_TEXT = `thingd
 
 Admin and operator CLI for thingd.
@@ -81,6 +82,10 @@ async function runCommand(context) {
         await runSearch(context);
         return;
     }
+    if (command === "mcp") {
+        await runMcp(context);
+        return;
+    }
     if (command === "objects") {
         await runObjects(context);
         return;
@@ -300,7 +305,7 @@ async function runQueues(context) {
         throw new Error(`Unknown queues action: ${action}`);
     });
 }
-async function withDb(context, callback) {
+export async function withDb(context, callback) {
     const connection = resolveConnection(context);
     const db = await ThingD.open({
         path: connection.path,
@@ -336,7 +341,7 @@ function buildMemoryEvent(parsed, type) {
         ...(text === undefined ? {} : { text }),
     };
 }
-function resolveConnection(context) {
+export function resolveConnection(context) {
     const url = stringFlag(context.parsed, "url") ?? context.env.THINGD_URL;
     const path = url ?? stringFlag(context.parsed, "path") ?? context.env.THINGD_PATH ?? ":memory:";
     const cloud = isCloudPath(path);

package/dist/mcp.d.ts

@@ -0,0 +1,3 @@
+import { type CliContext } from "./index.js";
+export declare function runMcp(context: CliContext): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAU,MAAM,YAAY,CAAC;AAErD,wBAAsB,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAY/D"}

package/dist/mcp.js

@@ -0,0 +1,14 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createThingdMcpServer } from "thingd-mcp";
+import { withDb } from "./index.js";
+export async function runMcp(context) {
+    await withDb(context, async (db) => {
+        // We pass empty options to createThingdMcpServer so it uses default audit behavior
+        const server = createThingdMcpServer(db);
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        // Keep the process alive and the database connection open
+        // so the MCP server can continue to receive messages over stdio.
+        return new Promise(() => { });
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thingd-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Admin and operator CLI for thingd.",
   "type": "module",
   "author": "Sayan Mohsin",
@@ -32,7 +32,8 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "cli-table3": "^0.6.5",
     "picocolors": "^1.1.1",
-    "thingd": "0.2.0"
+    "thingd": "0.3.0",
+    "thingd-mcp": "0.1.0"
   },
   "engines": {
     "node": ">=20"