collective-memory-mcp 0.1.0

package/README.md

@@ -0,0 +1,51 @@
+# Collective Memory MCP - npx Wrapper
+
+This package provides an `npx` wrapper for the Collective Memory MCP Server, making it easy to run without manually installing Python dependencies.
+
+## Usage
+
+```bash
+npx collective-memory-mcp
+```
+
+On first run, the wrapper will automatically:
+1. Detect Python on your system
+2. Install the `collective-memory-mcp` Python package via pip
+3. Start the MCP server
+
+## Claude Desktop Configuration
+
+```json
+{
+  "mcpServers": {
+    "collective-memory": {
+      "command": "npx",
+      "args": ["-y", "collective-memory-mcp"],
+      "env": {
+        "COLLECTIVE_MEMORY_DB_PATH": "/path/to/memory.db"
+      }
+    }
+  }
+}
+```
+
+The `-y` flag suppresses the npx prompt and auto-installs the latest version.
+
+## Requirements
+
+- Node.js 16+
+- Python 3.10+
+
+## Manual Python Installation
+
+If automatic installation fails, install manually:
+
+```bash
+pip install collective-memory-mcp
+```
+
+Then run directly with Python:
+
+```bash
+python -m collective_memory
+```

package/index.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+
+/**
+ * Collective Memory MCP Server - npx Wrapper
+ *
+ * This wrapper spawns the Python MCP server, making it available via npx:
+ *   npx collective-memory-mcp
+ *
+ * The Python package will be automatically installed on first run.
+ */
+
+import { spawn, spawnSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { existsSync, readFileSync } from 'fs';
+import { homedir } from 'os';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// ANSI color codes for better output
+const colors = {
+  reset: '\x1b[0m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m',
+};
+
+function log(message, color = 'reset') {
+  console.error(`${colors[color]}${message}${colors.reset}`);
+}
+
+function findPython() {
+  // Try different Python commands
+  const pythonCommands = ['python3', 'python', 'python3.12', 'python3.11', 'python3.10'];
+
+  for (const cmd of pythonCommands) {
+    const result = spawnSync(cmd, ['--version'], { stdio: 'pipe' });
+    if (result.status === 0) {
+      return cmd;
+    }
+  }
+
+  return null;
+}
+
+function getDbPath() {
+  // Allow override via environment variable
+  if (process.env.COLLECTIVE_MEMORY_DB_PATH) {
+    return process.env.COLLECTIVE_MEMORY_DB_PATH;
+  }
+
+  // Default to ~/.collective-memory/memory.db
+  return join(homedir(), '.collective-memory', 'memory.db');
+}
+
+async function main() {
+  const pythonCmd = findPython();
+
+  if (!pythonCmd) {
+    log('Error: Python 3.10+ is required but not found.', 'red');
+    log('Please install Python from https://python.org', 'yellow');
+    process.exit(1);
+  }
+
+  // Check if collective_memory module is available
+  const checkModule = spawnSync(pythonCmd, ['-c', 'import collective_memory'], {
+    stdio: 'pipe'
+  });
+
+  if (checkModule.status !== 0) {
+    log('Collective Memory MCP Server not found. Installing...', 'yellow');
+    log('', 'reset');
+
+    const installArgs = ['-m', 'pip', 'install', '-U', 'collective-memory-mcp'];
+    const install = spawn(pythonCmd, installArgs, {
+      stdio: 'inherit'
+    });
+
+    install.on('close', (code) => {
+      if (code !== 0) {
+        log('', 'reset');
+        log('Failed to install collective-memory-mcp Python package.', 'red');
+        log('You can install it manually:', 'yellow');
+        log(`  ${pythonCmd} -m pip install collective-memory-mcp`, 'cyan');
+        process.exit(1);
+      }
+
+      log('', 'reset');
+      log('Installation complete. Starting server...', 'green');
+      startServer(pythonCmd);
+    });
+  } else {
+    startServer(pythonCmd);
+  }
+}
+
+function startServer(pythonCmd) {
+  const dbPath = getDbPath();
+
+  // Spawn the Python MCP server
+  const server = spawn(pythonCmd, ['-m', 'collective_memory'], {
+    stdio: 'inherit',
+    env: {
+      ...process.env,
+      COLLECTIVE_MEMORY_DB_PATH: dbPath,
+      PYTHONUNBUFFERED: '1',
+    }
+  });
+
+  server.on('error', (err) => {
+    log(`Error starting server: ${err.message}`, 'red');
+    process.exit(1);
+  });
+
+  server.on('exit', (code) => {
+    process.exit(code ?? 0);
+  });
+}
+
+// Handle signals
+process.on('SIGINT', () => process.exit(0));
+process.on('SIGTERM', () => process.exit(0));
+
+main();

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "collective-memory-mcp",
+  "version": "0.1.0",
+  "description": "A persistent, graph-based memory system for AI agents (MCP Server)",
+  "type": "module",
+  "bin": {
+    "collective-memory-mcp": "./index.js"
+  },
+  "npx": {
+    "true": true
+  },
+  "scripts": {
+    "postinstall": "python -m pip install collective-memory-mcp || pip3 install collective-memory-mcp || pip install collective-memory-mcp"
+  },
+  "keywords": [
+    "mcp",
+    "memory",
+    "agents",
+    "ai",
+    "knowledge-graph",
+    "collective",
+    "anthropic",
+    "claude"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/YOUR_USERNAME/collective-memory-mcp.git"
+  },
+  "homepage": "https://github.com/YOUR_USERNAME/collective-memory-mcp#readme",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ]
+}