recallium 1.2.3 → 1.2.4

package/README.md

@@ -0,0 +1,67 @@
+# Recallium MCP Client
+
+MCP (Model Context Protocol) client for connecting AI coding assistants to the [Recallium](https://recallium.ai) memory server.
+
+## What is Recallium?
+
+Recallium is a persistent memory system for AI coding assistants. It remembers your decisions, code patterns, and project context across sessions - so your AI assistant doesn't start from scratch every time.
+
+## Quick Start
+
+### 1. Start the Recallium server
+
+```bash
+docker run -d -p 8001:8001 -p 9000:9000 recalliumai/recallium-community:latest
+```
+
+### 2. Configure your AI assistant
+
+**Cursor / Claude Desktop** (`~/.cursor/mcp.json` or `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "recallium": {
+      "command": "npx",
+      "args": ["-y", "recallium"],
+      "env": {
+        "RECALLIUM_SERVER_URL": "http://localhost:8001/mcp"
+      }
+    }
+  }
+}
+```
+
+### 3. Restart your AI assistant
+
+The Recallium tools will now be available to your AI.
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `RECALLIUM_SERVER_URL` | `http://localhost:8001/mcp` | URL of your Recallium server |
+| `RECALLIUM_DEBUG` | `false` | Enable debug logging |
+
+## Available Tools
+
+Once connected, your AI assistant gains access to:
+
+- **store_memory** - Save decisions, code snippets, and learnings
+- **search_memories** - Find relevant past context
+- **get_insights** - Analyze patterns across your work
+- **session_recap** - Resume where you left off
+- **projects** - Manage project briefs and documentation
+- **tasks** - Track TODOs and action items
+- **get_rules** - Load behavioral guidelines
+
+## Links
+
+- [Website](https://recallium.ai)
+- [Help & Documentation](https://www.recallium.ai/help)
+- [GitHub](https://github.com/recallium-ai/recallium)
+- [Docker Hub](https://hub.docker.com/r/recalliumai/recallium-community)
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recallium",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "description": "MCP client for connecting Cursor/VS Code to Recallium AI Memory Server",
   "author": "Recallium Team",
   "license": "MIT",
@@ -34,7 +34,11 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/recallium/recallium.git"
+    "url": "git+https://github.com/recallium-ai/recallium.git"
+  },
+  "homepage": "https://recallium.ai",
+  "bugs": {
+    "url": "https://github.com/recallium-ai/recallium/issues"
   },
   "publishConfig": {
     "access": "public"

package/src/index.js

@@ -12,21 +12,21 @@ import {
 } from '@modelcontextprotocol/sdk/types.js';
 import fetch from 'node-fetch';
 
-// Server configuration
-const RECALLIUM_SERVER_URL = process.env.RECALLIUM_SERVER_URL || 'http://localhost:8000/mcp';
-const DEBUG = process.env.RECALLIUM_DEBUG === 'true';
+// Server configuration - support both old and new env var names
+const RECALLIUM_SERVER_URL = process.env.RECALLIUM_SERVER_URL || process.env.RECALLIUM_SERVER_URL || 'http://localhost:8001/mcp';
+const DEBUG = process.env.RECALLIUM_DEBUG === 'true' || process.env.MINIME_DEBUG === 'true';
 
 // Logging helper
 function log(...args) {
   if (DEBUG) {
-    console.error('[Recallium MCP Client]', ...args);
+    console.error('[Recallium MCP]', ...args);
   }
 }
 
 // Create the MCP server that communicates via stdio with Cursor
 const server = new Server({
   name: "recallium",
-  version: "1.0.0"
+  version: "1.2.4"
 }, {
   capabilities: {
     tools: {},
@@ -56,7 +56,7 @@ async function callRecalliumServer(method, params = {}) {
       headers: {
         'Content-Type': 'application/json',
         'Accept': 'application/json, text/event-stream',
-        'User-Agent': 'Recallium-MCP-Client/1.0'
+        'User-Agent': 'Recallium-MCP/1.2.4'
       },
       body: JSON.stringify(requestBody)
     });
@@ -66,7 +66,7 @@ async function callRecalliumServer(method, params = {}) {
     }
 
     const result = await response.json();
-
+    
     if (result.error) {
       throw new Error(result.error.message || 'Unknown error');
     }
@@ -134,7 +134,7 @@ server.setRequestHandler(ListRootsRequestSchema, async () => {
 async function start() {
   log(`Starting Recallium MCP Client`);
   log(`Connecting to Recallium server at: ${RECALLIUM_SERVER_URL}`);
-
+  
   // Test connection to Recallium server
   try {
     // Extract base URL (remove /mcp if present)
@@ -142,7 +142,8 @@ async function start() {
     const response = await fetch(`${baseUrl}/health`);
     if (!response.ok) {
       console.error(`Warning: Recallium server at ${baseUrl} is not responding`);
-      console.error(`Make sure your Docker container is running: docker run -p 8000:8000 recallium`);
+      console.error(`Make sure your Docker container is running: docker run -p 8000:8000 recalliumai/recallium-community:latest`);
+      console.error(`For help, visit: https://www.recallium.ai/help`);
     } else {
       log('Successfully connected to Recallium server');
     }
@@ -150,7 +151,8 @@ async function start() {
     const baseUrl = RECALLIUM_SERVER_URL.replace(/\/mcp$/, '');
     console.error(`Warning: Cannot connect to Recallium server at ${baseUrl}`);
     console.error(`Error: ${error.message}`);
-    console.error(`Make sure your Docker container is running: docker run -p 8000:8000 recallium`);
+    console.error(`Make sure your Docker container is running: docker run -p 8000:8000 recalliumai/recallium-community:latest`);
+    console.error(`For help, visit: https://www.recallium.ai/help`);
   }
 
   const transport = new StdioServerTransport();