mem-brain-mcp 1.0.2__py3-none-any.whl → 1.0.4__py3-none-any.whl

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.4"
 

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"
             )
 
@@ -1101,16 +1143,27 @@ async def unlink_memories(memory_id_1: str, memory_id_2: str) -> str:
 
 
 @mcp.tool()
-async def get_stats() -> str:
+async def get_stats(_placeholder: Optional[bool] = None) -> str:
     """Get memory system statistics including total memories, links, and top tags. Use this when user asks 'how much do you remember?' or wants an overview of their memory system.
     
+    Parameters:
+        _placeholder (bool, optional): Placeholder parameter for OpenCode compatibility. This parameter is ignored and can be omitted or set to any value. The function takes no actual parameters.
+            - This is a workaround for MCP clients that incorrectly require a parameter for parameterless tools
+            - Can be safely omitted or set to None/True/False
+            - Example: get_stats() or get_stats(_placeholder=True)
+    
     Returns:
         str: Formatted statistics including total memories, links, and top tags.
     
     Examples:
-        # Get statistics
+        # Get statistics (preferred - no parameters needed)
         get_stats()
+        
+        # Get statistics (OpenCode workaround - parameter is ignored)
+        get_stats(_placeholder=True)
     """
+    # _placeholder parameter is ignored - this is a workaround for OpenCode compatibility
+    # The function actually takes no parameters, but some MCP clients incorrectly require one
     try:
         logger.info("get_stats called")
         client = await _get_api_client()

{mem_brain_mcp-1.0.2.dist-info → mem_brain_mcp-1.0.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mem-brain-mcp
-Version: 1.0.2
+Version: 1.0.4
 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.4.dist-info/RECORD

@@ -0,0 +1,9 @@
+mem_brain_mcp/__init__.py,sha256=IxDcMoheWmVbcdZEJSXj5fAx0WlYMjVonvvG0boqsec,89
+mem_brain_mcp/__main__.py,sha256=H_mwoKm1FBmu4KzAcQcq-TXZqeNvlrAekAxB1s4F4hA,712
+mem_brain_mcp/client.py,sha256=7KFGcLoPDaOOLiuG2lygQK7xH5Kio-YifDjuSpDoDJ8,6993
+mem_brain_mcp/config.py,sha256=xx2lBkCIeT85t0HxtORwZHSU3hZT_EdsThpfjwPJhbQ,1261
+mem_brain_mcp/server.py,sha256=Yw92d-Qy5kRDAaIC8VjEKBOYKCy2p6neZ9OSfxsThdY,69640
+mem_brain_mcp-1.0.4.dist-info/METADATA,sha256=7N3lTIQRHbFLfYdZyf2GZIowXEbmofVxO8QOrPFUCkE,5228
+mem_brain_mcp-1.0.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+mem_brain_mcp-1.0.4.dist-info/entry_points.txt,sha256=NH6QYQ-Sd8eJn5crpe_DL1PvGeUlL3y65968xPhmwG8,62
+mem_brain_mcp-1.0.4.dist-info/RECORD,,

mem_brain_mcp-1.0.2.dist-info/RECORD

@@ -1,9 +0,0 @@
-mem_brain_mcp/__init__.py,sha256=NMoDpXlRhGO858M6lrLqPN0fz7hKpqler4e96WniWxg,89
-mem_brain_mcp/__main__.py,sha256=H_mwoKm1FBmu4KzAcQcq-TXZqeNvlrAekAxB1s4F4hA,712
-mem_brain_mcp/client.py,sha256=7KFGcLoPDaOOLiuG2lygQK7xH5Kio-YifDjuSpDoDJ8,6993
-mem_brain_mcp/config.py,sha256=xx2lBkCIeT85t0HxtORwZHSU3hZT_EdsThpfjwPJhbQ,1261
-mem_brain_mcp/server.py,sha256=qnevDzJkt1rH-slV2r0pP_SeFkknZVqWRnZEKH_IeVo,66308
-mem_brain_mcp-1.0.2.dist-info/METADATA,sha256=zLQMVD-sIRSH03dYAP6RovZH_49XqREG061Yf87ROW4,5228
-mem_brain_mcp-1.0.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-mem_brain_mcp-1.0.2.dist-info/entry_points.txt,sha256=NH6QYQ-Sd8eJn5crpe_DL1PvGeUlL3y65968xPhmwG8,62
-mem_brain_mcp-1.0.2.dist-info/RECORD,,