@joseairosa/recall 1.8.2 → 1.9.0

package/.claude/rules/adding-mcp-tools.md

@@ -0,0 +1,59 @@
+# Adding MCP Tools
+
+Pattern for adding new tools to the Recall MCP server.
+
+## Steps
+
+1. **Add Zod schema** to `src/types.ts`
+2. **Add method** to `MemoryStore` in `src/persistence/memory-store.ts`
+3. **Add tool handler** to `src/tools/index.ts` or a new file (e.g., `src/tools/my-tools.ts`)
+4. **Register in HTTP handler** at `src/http/mcp-handler.ts` (for SaaS transport)
+
+## Tool File Pattern
+
+For a new tool group, use the module-level setter pattern:
+
+```typescript
+// src/tools/my-tools.ts
+import { MemoryStore } from '../persistence/memory-store.js';
+
+let memoryStore: MemoryStore | null = null;
+
+export function setMyMemoryStore(store: MemoryStore) {
+  memoryStore = store;
+}
+
+export const myTools = [
+  {
+    name: 'my_tool',
+    description: '...',
+    inputSchema: { type: 'object', properties: { ... } },
+  }
+];
+
+export async function handleMyTool(args: unknown) {
+  if (!memoryStore) throw new McpError(ErrorCode.InternalError, 'Store not initialized');
+  // ...
+}
+```
+
+Then register in `src/tools/index.ts`:
+```typescript
+import { myTools, setMyMemoryStore } from './my-tools.js';
+// Add to tools array and setMemoryStore function
+```
+
+## Error Handling
+
+Always use MCP error codes:
+```typescript
+import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+throw new McpError(ErrorCode.InvalidRequest, 'message');
+throw new McpError(ErrorCode.InternalError, 'message');
+```
+
+## Testing
+
+- Place tests as `src/tools/my-tools.test.ts`
+- Use `MockMemoryStore` from `src/__mocks__/memory-store.mock.ts`
+- For service logic: create `src/services/my.service.ts` + `my.service.test.ts`

package/.claude/rules/project.md

@@ -0,0 +1,64 @@
+# Project: Recall MCP Server
+
+**Last Updated:** 2026-02-17
+
+## Overview
+
+Redis/Valkey-powered MCP (Model Context Protocol) server providing long-term memory for Claude conversations. Stores context with semantic search via embeddings. Deployed as both stdio (self-hosted) and HTTP (SaaS at recallmcp.com).
+
+## Technology Stack
+
+- **Language:** TypeScript (strict, ESM)
+- **Runtime:** Node.js ≥18
+- **Build Tool:** tsup (ESM output)
+- **Testing:** Vitest
+- **Package Manager:** npm
+- **Storage:** Redis (ioredis) or Valkey (@valkey/valkey-glide)
+- **MCP SDK:** @modelcontextprotocol/sdk
+- **HTTP Framework:** Express 5
+- **Auth:** Firebase Admin (SaaS), API keys
+- **Billing:** Stripe
+- **IDs:** ULID (never auto-increment)
+
+## Directory Structure
+
+```
+src/
+├── index.ts              # MCP stdio entry point
+├── server-http.ts        # HTTP/SaaS entry point
+├── types.ts              # Zod schemas, all shared types
+├── persistence/          # Storage layer (Redis/Valkey adapters)
+├── embeddings/           # Multi-provider embedding system
+├── services/             # Business logic (rlm.service.ts)
+├── tools/                # MCP tool handlers
+├── resources/            # MCP resource handlers
+├── prompts/              # MCP prompt handlers
+├── analysis/             # Claude-powered conversation analysis
+└── http/                 # HTTP/SaaS infrastructure
+```
+
+## Development Commands
+
+- **Build:** `npm run build`
+- **Dev (watch):** `npm run dev`
+- **Start (stdio):** `npm run start`
+- **Start (HTTP):** `npm run start:http`
+- **Test:** `npm test`
+- **Test (watch):** `npm run test:watch`
+- **Coverage:** `npm run test:coverage`
+
+## Architecture Notes
+
+- **Two transports:** stdio (single-tenant, self-hosted) vs HTTP (multi-tenant SaaS)
+- **Storage abstraction:** `StorageClient` interface with Redis and Valkey adapters
+- **Embedding auto-detection:** Factory picks provider from available API keys (Voyage > Cohere > OpenAI > Anthropic fallback)
+- **Workspace isolation:** Memories scoped by workspace path; global memories cross workspaces
+- **Redis key patterns are immutable** — changing them requires migration
+
+## Critical Constraints
+
+- **Never remove context types** from `ContextType` enum in `types.ts` (breaks existing memories)
+- **Redis key patterns** are immutable; document migration path if changing
+- **Backward compatibility** on all public MCP tool interfaces
+- **Always use ULID** for new IDs (`ulid()` from the `ulid` package)
+- **ESM imports** must use `.js` extensions (even for `.ts` source files)

package/.claude/settings.local.json

@@ -37,7 +37,9 @@
       "Bash(gh run list:*)",
       "Bash(xargs -I {} git push origin --delete {})",
       "Read(//Users/joseairosa/Development/mcp/mem/**)",
-      "Bash(find:*)"
+      "Bash(find:*)",
+      "mcp__recall-remote__store_memory",
+      "mcp__recall-remote__set_workspace"
     ],
     "deny": [],
     "ask": [],

package/.nvmrc

@@ -0,0 +1 @@
+22