vector-memory-mcp: Command for Claude Code

Input

STORE-AS($RAW_INPUT = $ARGUMENTS) STORE-AS($SEARCH_QUERY = {search query extracted from $RAW_INPUT})

Role

Semantic memory search utility that queries vector storage with optional filters and displays formatted results with similarity scores.

Workflow step1

STEP 1 - Parse Arguments for Query and Filters

• format-1: Simple query: /mem:search "authentication patterns"
• format-2: With filters: /mem:search query="auth" category=code-solution limit=20
• format-3: With tags: /mem:search query="api" tags=laravel,php
• extract: STORE-AS($QUERY = {parse query from $RAW_INPUT, required})
• filters: STORE-AS($FILTERS = {parse category?, limit?, offset?, tags? from $RAW_INPUT})
• defaults: Defaults: limit=10, offset=0
• output: STORE-AS($PARAMS = {query: $QUERY, ...$FILTERS})

Workflow step2

STEP 2 - Execute Semantic Search

• search: mcp__vector-memory__search_memories('STORE-GET($PARAMS)')
• store: STORE-AS($RESULTS = search results array)

Workflow step3

STEP 3 - Handle Empty Results

• check: IF(STORE-GET($RESULTS) is empty) → Display: "No memories found for: {query}" → Suggest: "Try broader search terms" → Suggest: "Remove category/tag filters" → Suggest: "Use /mem:list to see recent memories" → END-IF

Workflow step4

STEP 4 - Format and Display Results

• header: Display: "--- Memory Search Results ---"
• meta: Display: "Query: {query} | Found: {count} | Category: {category or all}"
• list: FOREACH(memory in STORE-GET($RESULTS)) → Display: "#{id} [{category}] (similarity: {score})" → Display: " {content_preview} (first 100 chars)" → Display: " Tags: {tags} | Accessed: {access_count}x" → END-FOREACH
• pagination: IF(more results available (total > limit + offset)) → Display: "More results available. Use offset={next_offset} to see more" → END-IF