mem-brain-mcp 1.0.2__tar.gz → 1.0.3__tar.gz

{mem_brain_mcp-1.0.2 → mem_brain_mcp-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mem-brain-mcp
-Version: 1.0.2
+Version: 1.0.3
 Summary: MCP Server for Mem-Brain API - Exposes memory operations as MCP tools
 Keywords: ai,claude,cursor,llm,mcp,memory,model-context-protocol
 Classifier: Development Status :: 4 - Beta

{mem_brain_mcp-1.0.2 → mem_brain_mcp-1.0.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mem-brain-mcp"
-version = "1.0.2"
+version = "1.0.3"
 description = "MCP Server for Mem-Brain API - Exposes memory operations as MCP tools"
 readme = "README.md"
 requires-python = ">=3.10,<3.14"

{mem_brain_mcp-1.0.2 → mem_brain_mcp-1.0.3}/src/mem_brain_mcp/__init__.py

@@ -1,4 +1,4 @@
 """Mem-Brain MCP Server - Exposes Mem-Brain API as MCP tools."""
 
-__version__ = "1.0.2"
+__version__ = "1.0.3"
 

{mem_brain_mcp-1.0.2 → mem_brain_mcp-1.0.3}/src/mem_brain_mcp/server.py

@@ -1,5 +1,6 @@
 """MCP Server for Mem-Brain API using FastMCP."""
 
+import json
 import logging
 from typing import Any, Dict, List, Optional, Union
 import httpx
@@ -407,11 +408,13 @@ async def add_memory(
             - Example: "User prefers Python over JavaScript"
             - Example: "User prefers dark mode interfaces"
         
-        tags (list[str], optional): List of tags to categorize the memory. 
-            - Can be None (default) or a list of strings
+        tags (list[str] or str, optional): Tags to categorize the memory. 
+            - Can be None (default), a list of strings, a comma-separated string, or a JSON array string
+            - If omitted, the system will auto-generate tags based on content
             - Example: ["coding", "preferences"]
-            - Example: ["personal", "pets", "animals"]
-            - If you pass a single string, it will be converted to a list
+            - Example: "coding,preferences" (comma-separated)
+            - Example: '["coding", "preferences"]' (JSON string)
+            - Note: The system auto-generates relevant tags, so providing tags is optional
         
         category (str, optional): Category name for the memory.
             - Can be None (default) or a non-empty string
@@ -480,7 +483,7 @@ async def add_memory(
         logger.info(f"add_memory called - content length: {len(content_str)}, tags: {tags}, category: {category}")
         logger.debug(f"add_memory full content: {content_str[:100]}...")
         
-        # Normalize tags: convert empty list to None, ensure it's a list if provided
+        # Normalize tags: handle various input formats and convert to list of strings
         normalized_tags = None
         if tags is not None:
             if isinstance(tags, list):
@@ -495,13 +498,31 @@ async def add_memory(
                         )
                 normalized_tags = tags if tags else None  # Empty list becomes None
             elif isinstance(tags, str):
-                # Handle case where tags might be passed as a single string
-                normalized_tags = [tags]
+                tags_str = tags.strip()
+                if not tags_str:
+                    normalized_tags = None
+                else:
+                    # Try to parse as JSON array first (e.g., '["tag1", "tag2"]')
+                    try:
+                        parsed = json.loads(tags_str)
+                        if isinstance(parsed, list):
+                            normalized_tags = [str(item).strip() for item in parsed if str(item).strip()]
+                        else:
+                            # If JSON but not a list, treat as single tag
+                            normalized_tags = [tags_str]
+                    except (json.JSONDecodeError, ValueError):
+                        # Not JSON, try comma-separated string
+                        if ',' in tags_str:
+                            normalized_tags = [tag.strip() for tag in tags_str.split(',') if tag.strip()]
+                        else:
+                            # Single tag string
+                            normalized_tags = [tags_str]
             else:
                 raise ToolError(
-                    f"The 'tags' parameter must be a list of strings or None, but got {type(tags).__name__}.\n"
+                    f"The 'tags' parameter must be a list of strings, a comma-separated string, or None, but got {type(tags).__name__}.\n"
                     f"Received: {repr(tags)}\n"
                     "Example: add_memory(content=\"...\", tags=[\"coding\", \"preferences\"])\n"
+                    "Example: add_memory(content=\"...\", tags=\"coding,preferences\")\n"
                     "Example: add_memory(content=\"...\", tags=None)  # or omit tags parameter"
                 )
         
@@ -738,10 +759,13 @@ async def update_memory(
             - If provided, must not be empty or whitespace-only
             - Example: "User no longer likes TypeScript, prefers Python"
         
-        tags (list[str], optional): New tags for the memory.
-            - Can be None (to keep existing tags) or a list of strings
+        tags (list[str] or str, optional): New tags for the memory.
+            - Can be None (to keep existing tags), a list of strings, a comma-separated string, or a JSON array string
+            - If provided, replaces existing tags
             - Example: ["coding", "python"]
-            - Example: ["preferences", "updated"]
+            - Example: "coding,python" (comma-separated)
+            - Example: '["coding", "python"]' (JSON string)
+            - Note: The system can auto-generate tags if you omit this parameter
     
     Returns:
         str: A formatted string with the updated memory details.
@@ -819,7 +843,7 @@ async def update_memory(
     else:
         content_str = None
     
-    # Validate tags if provided
+    # Validate tags if provided - handle various input formats
     normalized_tags = None
     if tags is not None:
         if isinstance(tags, list):
@@ -834,13 +858,31 @@ async def update_memory(
                     )
             normalized_tags = tags if tags else None  # Empty list becomes None
         elif isinstance(tags, str):
-            # Handle case where tags might be passed as a single string
-            normalized_tags = [tags]
+            tags_str = tags.strip()
+            if not tags_str:
+                normalized_tags = None
+            else:
+                # Try to parse as JSON array first (e.g., '["tag1", "tag2"]')
+                try:
+                    parsed = json.loads(tags_str)
+                    if isinstance(parsed, list):
+                        normalized_tags = [str(item).strip() for item in parsed if str(item).strip()]
+                    else:
+                        # If JSON but not a list, treat as single tag
+                        normalized_tags = [tags_str]
+                except (json.JSONDecodeError, ValueError):
+                    # Not JSON, try comma-separated string
+                    if ',' in tags_str:
+                        normalized_tags = [tag.strip() for tag in tags_str.split(',') if tag.strip()]
+                    else:
+                        # Single tag string
+                        normalized_tags = [tags_str]
         else:
             raise ToolError(
-                f"The 'tags' parameter must be a list of strings or None, but got {type(tags).__name__}.\n"
+                f"The 'tags' parameter must be a list of strings, a comma-separated string, or None, but got {type(tags).__name__}.\n"
                 f"Received: {repr(tags)}\n"
                 "Example: update_memory(memory_id=\"...\", tags=[\"coding\", \"preferences\"])\n"
+                "Example: update_memory(memory_id=\"...\", tags=\"coding,preferences\")\n"
                 "Example: update_memory(memory_id=\"...\", tags=None)  # or omit tags parameter"
             )