prism-mcp-server 2.3.0 → 2.3.2

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/prism-mcp-server?color=cb0000&label=npm)](https://www.npmjs.com/package/prism-mcp-server)
 [![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-00ADD8?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0xMiAyTDIgN2wxMCA1IDEwLTUtMTAtNXpNMiAxN2wxMCA1IDEwLTV2LTJMMTI0djJMMiA5djh6Ii8+PC9zdmc+)](https://registry.modelcontextprotocol.io)
-[![Glama](https://img.shields.io/badge/Glama-listed-FF5601)](https://glama.ai/mcp/servers/@dcostenco/prism-mcp)
+[![Glama](https://img.shields.io/badge/Glama-listed-FF5601)](https://glama.ai/mcp/servers/dcostenco/BCBA)
 [![Smithery](https://img.shields.io/badge/Smithery-listed-6B4FBB)](https://smithery.ai/server/prism-mcp-server)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
@@ -14,7 +14,7 @@
 
 ---
 
-## What's New in v2.3.0 — AI Reasoning Engine 🧠
+## What's New in v2.3.1 — AI Reasoning Engine 🧠
 
 | Feature | Description |
 |---|---|
@@ -50,6 +50,31 @@
 
 ---
 
+## How Prism Compares
+
+| Feature | **Prism MCP** | [MCP Memory](https://github.com/modelcontextprotocol/servers/tree/main/src/memory) | [Mem0](https://github.com/mem0ai/mem0) | [Mnemory](https://github.com/fpytloun/mnemory) | [Basic Memory](https://github.com/basicmachines-co/basic-memory) |
+|---|---|---|---|---|---|
+| **Storage** | SQLite (local) + Supabase (cloud) | JSON file | Postgres + Qdrant (hosted or self-hosted) | Qdrant + S3/MinIO | Markdown files |
+| **Zero Config** | ✅ `npx -y prism-mcp-server` | ✅ | ❌ Requires Qdrant/Postgres | ✅ `uvx mnemory` | ✅ `pip install basic-memory` |
+| **Semantic Search** | ✅ F32_BLOB vectors + FTS5 | ❌ | ✅ pgvector | ✅ Qdrant vectors | ❌ Text search only |
+| **Knowledge Graph** | ✅ Neural Graph (Vis.js dashboard) | ✅ Entity/Relation model | ❌ | ✅ Relationship graph | ✅ Markdown links |
+| **Time Travel** | ✅ `memory_history` / `memory_checkout` | ❌ | ❌ | ❌ | ❌ |
+| **Fact Merging** | ✅ Async Gemini (fire-and-forget) | ❌ | ✅ Built-in | ✅ Contradiction resolution | ❌ |
+| **Security Scan** | ✅ Prompt injection detection | ❌ | ❌ | ✅ Anti-injection in fsck | ❌ |
+| **Health Check** | ✅ `session_health_check` (fsck) | ❌ | ❌ | ✅ 3-phase fsck | ❌ |
+| **Visual Dashboard** | ✅ Mind Palace (localhost:3000) | ❌ | ✅ Cloud dashboard | ✅ Management UI | ❌ |
+| **Multi-Agent Sync** | ✅ Real-time cross-client | ❌ | ❌ | ❌ Per-user isolation | ❌ |
+| **Visual Memory** | ✅ Screenshot vault + auto-capture | ❌ | ❌ | ✅ Artifact store | ❌ |
+| **Auto-Compaction** | ✅ Gemini rollups | ❌ | ❌ | ❌ | ❌ |
+| **Morning Briefing** | ✅ Gemini synthesis | ❌ | ❌ | ❌ | ❌ |
+| **OCC (Concurrency)** | ✅ Version-based | ❌ | ❌ | ❌ | ❌ |
+| **MCP Native** | ✅ stdio (Claude Desktop, Cursor) | ✅ stdio | ❌ Python SDK / REST | ✅ HTTP + MCP | ✅ stdio |
+| **Language** | TypeScript | TypeScript | Python | Python | Python |
+
+> **When to choose Prism MCP:** You want MCP-native memory with zero infrastructure overhead, progressive context loading, and enterprise features (OCC, compaction, time travel, security scanning) that work directly in Claude Desktop — without running Qdrant, Postgres, or cloud services.
+
+---
+
 ## Quick Start (Zero Config — Local Mode)
 
 Get the MCP server running with Claude Desktop or Cursor in **under 60 seconds**. No API keys required for basic local memory!
@@ -140,25 +165,6 @@ The dashboard auto-discovers all your projects and updates in real time.
 
 ---
 
-## How Prism MCP Compares
-
-| Capability | **Prism MCP** | **Mem0** | **Zep** | **Basic Memory** |
-|---|---|---|---|---|
-| **Architecture** | MCP-native (single npm package) | Standalone service + MCP adapter | Standalone service + API | MCP-native (local files) |
-| **Storage** | SQLite (local) or Supabase (cloud) | Hybrid (vector + graph DBs) | PostgreSQL + Neo4j | Local markdown files |
-| **Local-First** | ✅ Full SQLite mode, zero cloud | ❌ Requires cloud/Docker | ❌ Requires PostgreSQL | ✅ Local files |
-| **Visual Dashboard** | ✅ Mind Palace UI at localhost:3000 | ❌ No UI | ❌ No UI | ❌ No UI |
-| **Time Travel** | ✅ Version history + checkout | ❌ No versioning | ❌ No versioning | ❌ No versioning |
-| **Multi-Agent Sync** | ✅ Telepathy (realtime IPC/CDC) | ❌ Siloed | ❌ Siloed | ❌ Single user |
-| **Auto-Capture** | ✅ HTML snapshots of dev server | ❌ Text only | ❌ Text only | ❌ Text only |
-| **Cold Start Fix** | ✅ MCP Prompts + Resources | ❌ Requires tool call | ❌ Requires tool call | ❌ Requires tool call |
-| **Progressive Loading** | ✅ quick / standard / deep | ❌ All-or-nothing | ❌ Fixed window | ❌ All-or-nothing |
-| **Semantic Search** | ✅ F32_BLOB vectors (local) or pgvector (cloud) | ✅ Qdrant/Chroma | ✅ Built-in | ❌ None |
-| **Concurrency Control** | ✅ OCC with version tracking | ❌ Last write wins | ❌ Last write wins | ❌ Single user |
-| **Setup Complexity** | Zero config (local mode) | Docker + API keys + vector DB | Docker + PostgreSQL + Neo4j | No setup needed |
-
----
-
 ## Integration Examples
 
 Copy-paste configs for popular MCP clients. All configs use the `npx` method.

package/dist/config.js

@@ -22,13 +22,12 @@
 // multi-tenant Row Level Security (RLS) for production hosting.
 export const SERVER_CONFIG = {
     name: "prism-mcp",
-    version: "1.5.0",
+    version: "2.3.2",
 };
 // ─── Required: Brave Search API Key ───────────────────────────
 export const BRAVE_API_KEY = process.env.BRAVE_API_KEY;
 if (!BRAVE_API_KEY) {
-    console.error("Error: BRAVE_API_KEY environment variable is required");
-    process.exit(1);
+    console.error("Warning: BRAVE_API_KEY environment variable is missing. Search tools will return errors when called.");
 }
 // ─── Optional: Google Gemini API Key ──────────────────────────
 // Used by the gemini_research_paper_analysis tool.

package/dist/dashboard/ui.js

@@ -1,5 +1,5 @@
 /**
- * Mind Palace Dashboard — UI Renderer (v2.2.0)
+ * Mind Palace Dashboard — UI Renderer (v2.3.1)
  *
  * Pure CSS + Vanilla JS single-page dashboard.
  * No build step, no Tailwind, no framework — served as a template literal.
@@ -279,7 +279,7 @@ export function renderDashboardHTML() {
       <div class="logo">
         <span class="logo-icon">🧠</span>
         Prism Mind Palace
-        <span class="version-badge">v2.2.0</span>
+        <span class="version-badge">v2.3.1</span>
       </div>
       <div class="selector">
         <select id="projectSelect">

package/dist/server.js

@@ -118,10 +118,12 @@ const SESSION_MEMORY_TOOLS = [
     // ─── v2.2.0: Health Check tool ───
     SESSION_HEALTH_CHECK_TOOL, // session_health_check — brain integrity checker (v2.2.0)
 ];
-// Combine: if session memory is enabled, add those tools too
+// Combine: always list ALL tools so scanners (Glama, Smithery, MCP Registry)
+// can enumerate the full capability set. Runtime guards in the CallTool handler
+// still prevent execution without valid Supabase credentials.
 const ALL_TOOLS = [
     ...BASE_TOOLS,
-    ...(SESSION_MEMORY_ENABLED ? SESSION_MEMORY_TOOLS : []),
+    ...SESSION_MEMORY_TOOLS,
 ];
 // ─── v0.4.0: Resource Subscription Tracking ──────────────────────
 // REVIEWER NOTE: We track which project URIs clients have subscribed
@@ -527,11 +529,65 @@ export function createServer() {
     });
     return server;
 }
-// ─── Smithery Sandbox Export ─────────────────────────────────────
-// Smithery uses this to scan capabilities (tools, prompts, resources)
-// without requiring real credentials or starting a transport.
+// ─── Smithery/Glama Sandbox Export ───────────────────────────────
+// Scanners (Smithery, Glama) use this to enumerate capabilities
+// (tools, prompts, resources) without requiring real credentials.
+// Unlike createServer(), this always exposes ALL capabilities
+// regardless of whether SESSION_MEMORY_ENABLED is true.
 export function createSandboxServer() {
-    return createServer();
+    const server = new Server({
+        name: SERVER_CONFIG.name,
+        version: SERVER_CONFIG.version,
+    }, {
+        capabilities: {
+            tools: {
+                tools: [...BASE_TOOLS, ...SESSION_MEMORY_TOOLS],
+            },
+            prompts: {},
+            resources: { subscribe: true },
+        },
+    });
+    // Register all tool listings unconditionally
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [...BASE_TOOLS, ...SESSION_MEMORY_TOOLS],
+    }));
+    // Register prompts listing so scanners see resume_session
+    server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+        prompts: [{
+                name: "resume_session",
+                description: "Load previous session context for a project. " +
+                    "Automatically fetches handoff state and injects it before " +
+                    "the LLM starts thinking — no tool call needed. " +
+                    "Includes version tracking for concurrency control.",
+                arguments: [
+                    {
+                        name: "project",
+                        description: "Project identifier to resume (e.g., 'prism-mcp')",
+                        required: true,
+                    },
+                    {
+                        name: "level",
+                        description: "Context depth: 'quick' (~50 tokens), " +
+                            "'standard' (~200 tokens, recommended), " +
+                            "'deep' (full history, ~1000+ tokens)",
+                        required: false,
+                    },
+                ],
+            }],
+    }));
+    // Register resource templates so scanners see memory://{project}/handoff
+    server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({
+        resourceTemplates: [{
+                uriTemplate: "memory://{project}/handoff",
+                name: "Session Handoff State",
+                description: "Current handoff state for a project — includes " +
+                    "last summary, pending TODOs, active decisions, keywords, " +
+                    "and version number for concurrency control. " +
+                    "Attach this to inject session context without a tool call.",
+                mimeType: "application/json",
+            }],
+    }));
+    return server;
 }
 // ─── Server Startup ─────────────────────────────────────────────
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prism-mcp-server",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "mcpName": "io.github.dcostenco/prism-mcp",
   "description": "The Mind Palace for AI Agents — local-first MCP server with persistent memory (SQLite/Supabase), visual dashboard, time travel, multi-agent sync, Morning Briefings, reality drift detection, code mode templates, semantic vector search, and Brave Search + Gemini analysis. Zero-config local mode.",
   "module": "index.ts",