@smartergpt/lex-mcp 1.0.0

package/README.md

@@ -0,0 +1,72 @@
+# @smartergpt/lex-mcp
+
+MCP server wrapper for [Lex](https://github.com/Guffawaffle/lex) episodic memory.
+
+## Quick Start
+
+```bash
+npx @smartergpt/lex-mcp
+```
+
+## Configuration
+
+### VS Code / Copilot
+
+Add to `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "lex": {
+      "command": "npx",
+      "args": ["@smartergpt/lex-mcp"],
+      "env": {
+        "LEX_WORKSPACE_ROOT": "${workspaceFolder}"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "lex": {
+      "command": "npx",
+      "args": ["@smartergpt/lex-mcp"]
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `LEX_WORKSPACE_ROOT` | Workspace root directory | Current directory |
+| `LEX_MEMORY_DB` | SQLite database path | `.smartergpt/lex/lex.db` |
+| `LEX_DEBUG` | Enable debug logging | Off |
+
+## Tools
+
+This MCP server provides 11 tools for episodic memory management:
+
+- `frame_create` - Store episodic memory snapshot
+- `frame_search` - Search frames by reference, branch, or ticket
+- `frame_get` - Retrieve specific frame by ID
+- `frame_list` - List recent frames with filtering
+- `frame_validate` - Validate frame input (dry-run)
+- `policy_check` - Validate code against policy rules
+- `timeline_show` - Visual timeline of frame evolution
+- `atlas_analyze` - Analyze code structure and dependencies
+- `system_introspect` - Discover Lex capabilities and state
+- `help` - Usage help and examples
+- `hints_get` - Retrieve error recovery hints
+
+## Learn More
+
+See the [Lex documentation](https://github.com/Guffawaffle/lex) for full details.

package/index.mjs

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+/**
+ * @smartergpt/lex-mcp - MCP Server Entry Point
+ *
+ * Thin wrapper that starts the Lex MCP server over stdio.
+ * This package exists to provide a clean npx launch target for the MCP registry.
+ *
+ * Usage:
+ *   npx @smartergpt/lex-mcp
+ *
+ * Environment Variables:
+ *   LEX_WORKSPACE_ROOT - Workspace root directory (default: cwd)
+ *   LEX_MEMORY_DB      - SQLite database path (default: .smartergpt/lex/lex.db)
+ *   LEX_DEBUG          - Enable debug logging to stderr
+ */
+
+import { MCPServer } from "@smartergpt/lex/mcp-server";
+import { join } from "path";
+
+// Workspace root defaults to current working directory
+const repoRoot = process.env.LEX_WORKSPACE_ROOT || process.cwd();
+
+// Set LEX_WORKSPACE_ROOT for modules that need it
+if (!process.env.LEX_WORKSPACE_ROOT) {
+  process.env.LEX_WORKSPACE_ROOT = repoRoot;
+}
+
+// Database path defaults to .smartergpt/lex/lex.db in workspace root
+const dbPath =
+  process.env.LEX_MEMORY_DB || join(repoRoot, ".smartergpt", "lex", "lex.db");
+
+// Initialize MCP server
+let mcpServer;
+try {
+  mcpServer = new MCPServer(dbPath, repoRoot);
+  if (process.env.LEX_DEBUG) {
+    console.error(`[LEX-MCP] Server initialized: ${dbPath}`);
+    console.error(`[LEX-MCP] Workspace root: ${repoRoot}`);
+  }
+} catch (error) {
+  console.error(`[LEX-MCP] Failed to initialize: ${error.message}`);
+  process.exit(1);
+}
+
+// MCP stdio protocol handler (JSON-RPC 2.0 over newline-delimited JSON)
+process.stdin.setEncoding("utf8");
+let buffer = "";
+
+process.stdin.on("data", async (chunk) => {
+  buffer += chunk;
+  const lines = buffer.split("\n");
+  buffer = lines.pop() || "";
+
+  for (const line of lines) {
+    if (!line.trim()) continue;
+
+    let request;
+    try {
+      request = JSON.parse(line);
+      const response = await mcpServer.handleRequest(request);
+
+      // MCP protocol response format
+      if (response.error) {
+        console.log(
+          JSON.stringify({
+            jsonrpc: "2.0",
+            id: request.id,
+            error: response.error,
+          })
+        );
+      } else {
+        console.log(
+          JSON.stringify({
+            jsonrpc: "2.0",
+            id: request.id,
+            result: response,
+          })
+        );
+      }
+    } catch (error) {
+      console.log(
+        JSON.stringify({
+          jsonrpc: "2.0",
+          id: request?.id || null,
+          error: {
+            message: error.message,
+            code: error.code || "PARSE_ERROR",
+          },
+        })
+      );
+    }
+  }
+});
+
+// Graceful shutdown
+process.on("SIGINT", () => {
+  if (mcpServer) mcpServer.close();
+  process.exit(0);
+});
+
+process.on("SIGTERM", () => {
+  if (mcpServer) mcpServer.close();
+  process.exit(0);
+});
+
+if (process.env.LEX_DEBUG) {
+  console.error("[LEX-MCP] Ready (stdio mode)");
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@smartergpt/lex-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Lex episodic memory - stdio transport wrapper",
+  "mcpName": "io.github.guffawaffle/lex",
+  "type": "module",
+  "bin": "./index.mjs",
+  "files": [
+    "index.mjs",
+    "README.md"
+  ],
+  "dependencies": {
+    "@smartergpt/lex": "^2.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Guffawaffle/lex.git",
+    "directory": "lex-mcp"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "lex",
+    "episodic-memory",
+    "ai-agents"
+  ],
+  "author": "Guffawaffle",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "homepage": "https://github.com/Guffawaffle/lex#readme",
+  "bugs": {
+    "url": "https://github.com/Guffawaffle/lex/issues"
+  }
+}