@cachly-dev/mcp-server 0.9.3 → 0.9.4

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@cachly-dev/mcp-server",
-  "version": "0.9.3",
+  "version": "0.9.4",
   "mcpName": "io.github.cachly-dev/cachly-mcp",
-  "description": "AI memory brain for Claude Code, Cursor, Copilot & Windsurf — persistent sessions, lessons learned, semantic search, Causal Knowledge Graph, team brain. 54 MCP tools.",
+  "description": "Persistent AI memory for Claude Code, Cursor, Copilot & Windsurf — 63 MCP tools. Causal Knowledge Graph, predictive failure detection, continuous learning from git commits + CI, federated knowledge sharing. Your AI learns from every bug fix and never re-researches the same problem.",
   "type": "module",
   "bin": {
     "cachly-mcp": "dist/index.js"
@@ -34,7 +34,7 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/cachly-dev/cachly-mcp.git"
+    "url": "git+https://github.com/cachly-dev/cachly.git"
   },
   "publishConfig": {
     "access": "public",
@@ -51,6 +51,8 @@
     "windsurf",
     "continue",
     "ai-memory",
+    "ai-brain",
+    "persistent-memory",
     "brain",
     "sessions",
     "lessons-learned",
@@ -58,15 +60,22 @@
     "team-knowledge",
     "ambient-git",
     "memory-crystals",
+    "causal-knowledge-graph",
+    "continuous-learning",
+    "predictive-ai",
     "cachly",
     "redis",
     "valkey",
     "cache",
     "ai",
-    "llm"
+    "llm",
+    "knowledge-base",
+    "developer-productivity",
+    "ckg",
+    "mcp-server"
   ],
   "homepage": "https://cachly.dev/docs/mcp",
   "bugs": {
-    "url": "https://github.com/cachly-dev/cachly-mcp/issues"
+    "url": "https://github.com/cachly-dev/cachly/issues"
   }
 }

package/server.json

@@ -1,18 +1,18 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.cachly-dev/cachly-mcp",
-  "description": "AI memory brain for Claude Code, Cursor, Copilot & Windsurf — 51 MCP tools. Persistent sessions, lessons learned, semantic search, Team Telepathy, Ambient Git Learning, Memory Crystals.",
+  "description": "Persistent AI memory for Claude Code, Cursor, Copilot & Windsurf. Your AI learns from every bug fix and never re-researches the same problem. 63 MCP tools — Causal Knowledge Graph, predictive failure detection, continuous learning from git commits, federated knowledge sharing.",
   "repository": {
-    "url": "https://github.com/cachly-dev/cachly-mcp",
+    "url": "https://github.com/cachly-dev/cachly",
     "source": "github"
   },
-  "version": "0.8.2",
+  "version": "0.9.4",
   "packages": [
     {
       "registryType": "npm",
       "name": "@cachly-dev/mcp-server",
       "identifier": "@cachly-dev/mcp-server",
-      "version": "0.8.2",
+      "version": "0.9.4",
       "transport": {
         "type": "stdio"
       }

package/smithery.yaml

@@ -6,31 +6,32 @@ startCommand:
       CACHLY_JWT:
         type: string
         title: "API Key"
-        description: "Your Cachly API key. Get it free at cachly.dev/setup-ai → Dashboard → API Keys. Looks like: cky_live_..."
+        description: "Your Cachly API key (free, no credit card). Get it at cachly.dev/setup-ai → Dashboard → API Keys. Looks like: cky_live_... The server auto-detects your Brain instance from this key."
         examples:
           - "cky_live_abc123..."
       CACHLY_BRAIN_INSTANCE_ID:
         type: string
-        title: "Brain Instance ID"
-        description: "UUID of your Cachly Brain instance. Find it at cachly.dev/instances — click your instance and copy the ID from the URL or details panel. Looks like: 9d4077aa-bfa2-468b-89cd-0a8d8f3ec483"
+        title: "Brain Instance ID (optional)"
+        description: "UUID of your Brain instance — only needed if you have multiple instances. Leave blank and the server auto-picks your active instance. Find the ID at cachly.dev/instances."
         pattern: "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
         examples:
           - "9d4077aa-bfa2-468b-89cd-0a8d8f3ec483"
       CACHLY_API_URL:
         type: string
         title: "API URL (optional)"
-        description: "Cachly API endpoint — leave as default unless you self-host"
+        description: "Cachly API endpoint — leave blank unless you self-host"
         default: "https://api.cachly.dev"
     required:
       - CACHLY_JWT
-      - CACHLY_BRAIN_INSTANCE_ID
   commandFunction: |-
     (config) => ({
       command: "npx",
       args: ["-y", "@cachly-dev/mcp-server@latest"],
-      env: {
-        CACHLY_JWT: config.CACHLY_JWT,
-        CACHLY_BRAIN_INSTANCE_ID: config.CACHLY_BRAIN_INSTANCE_ID,
-        CACHLY_API_URL: config.CACHLY_API_URL ?? "https://api.cachly.dev",
-      }
+      env: Object.fromEntries(
+        Object.entries({
+          CACHLY_JWT: config.CACHLY_JWT,
+          CACHLY_BRAIN_INSTANCE_ID: config.CACHLY_BRAIN_INSTANCE_ID,
+          CACHLY_API_URL: config.CACHLY_API_URL ?? "https://api.cachly.dev",
+        }).filter(([, v]) => v != null && v !== "")
+      )
     })

package/src/index.ts

@@ -55,7 +55,31 @@ import { Redis } from 'ioredis';
 const API_URL = process.env.CACHLY_API_URL ?? 'https://api.cachly.dev';
 const JWT = process.env.CACHLY_JWT ?? '';
 const EMBED_MODEL = process.env.CACHLY_EMBED_MODEL ?? '';
-const CURRENT_VERSION = '0.9.3';
+const CURRENT_VERSION = '0.9.4';
+
+// ── Default Instance Resolution (for Smithery & single-credential setups) ────
+// When CACHLY_BRAIN_INSTANCE_ID is set, tools can omit the instance_id parameter.
+// When neither is set, we auto-fetch the first running instance once per process.
+let _defaultInstanceId: string = process.env.CACHLY_BRAIN_INSTANCE_ID ?? '';
+let _defaultInstanceFetched = false;
+
+async function resolveDefaultInstanceId(): Promise<string> {
+  if (_defaultInstanceId) return _defaultInstanceId;
+  if (_defaultInstanceFetched) return '';
+  _defaultInstanceFetched = true;
+  if (!JWT) return '';
+  try {
+    const res = await fetch(`${API_URL}/api/v1/instances`, {
+      headers: { Authorization: `Bearer ${JWT}`, Accept: 'application/json' },
+      signal: AbortSignal.timeout(5000),
+    });
+    if (!res.ok) return '';
+    const data = await res.json() as { data?: Array<{ id: string; status: string }> };
+    const running = (data?.data ?? []).filter(i => i.status === 'running');
+    if (running.length > 0) { _defaultInstanceId = running[0].id; return _defaultInstanceId; }
+  } catch { /* non-fatal — caller will surface missing instance_id error */ }
+  return '';
+}
 /**
  * ┌──────────────────────────────────────────────────────────────────────┐
  * │  EMBEDDING PROVIDER — pluggable, client-side first                  │
@@ -3871,6 +3895,12 @@ async function handleTool(name: string, args: Record<string, unknown>): Promise<
     ].join('\n');
   }
 
+  // Auto-resolve instance_id from env / API when not provided in args
+  if (!args.instance_id) {
+    const defaultId = await resolveDefaultInstanceId();
+    if (defaultId) args = { ...args, instance_id: defaultId };
+  }
+
   // Delegate v0.2 bulk/lock/stream tools first
   const bulkResult = await handleBulkLockStream(name, args);
   if (bulkResult !== null) return bulkResult;