mem-brain-mcp 1.0.9__tar.gz → 1.1.1__tar.gz

{mem_brain_mcp-1.0.9 → mem_brain_mcp-1.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mem-brain-mcp
-Version: 1.0.9
+Version: 1.1.1
 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
@@ -194,15 +194,40 @@ For detailed instructions, see [aws/DEPLOYMENT.md](./aws/DEPLOYMENT.md).
 pytest
 ```
 
-### Build and Publish
+### Build and Publish to PyPI
+
+**Prerequisites:** Ensure you have a PyPI account and your credentials are configured in `~/.pypirc`.
+
+**Step-by-step deployment:**
+
 ```bash
-# Build the wheel
-python3 -m build
+# 1. Activate the virtual environment
+cd mem-brain-mcp
+source .venv/bin/activate
+
+# 2. Update version in pyproject.toml
+# Edit pyproject.toml and increment the version number (e.g., 1.0.8 -> 1.0.9)
+
+# 3. Clean old builds
+rm -rf dist/*
+
+# 4. Build the package
+python -m build
 
-# Upload to PyPI
+# 5. Upload to PyPI using twine
 twine upload dist/*
 ```
 
+**Quick deployment (one-liner after version bump):**
+```bash
+source .venv/bin/activate && rm -rf dist/* && python -m build && twine upload dist/*
+```
+
+**Verify deployment:**
+```bash
+pip3 index versions mem-brain-mcp
+```
+
 ## License
 
 Same as Mem-Brain API project.

{mem_brain_mcp-1.0.9 → mem_brain_mcp-1.1.1}/README.md

@@ -168,15 +168,40 @@ For detailed instructions, see [aws/DEPLOYMENT.md](./aws/DEPLOYMENT.md).
 pytest
 ```
 
-### Build and Publish
+### Build and Publish to PyPI
+
+**Prerequisites:** Ensure you have a PyPI account and your credentials are configured in `~/.pypirc`.
+
+**Step-by-step deployment:**
+
 ```bash
-# Build the wheel
-python3 -m build
+# 1. Activate the virtual environment
+cd mem-brain-mcp
+source .venv/bin/activate
+
+# 2. Update version in pyproject.toml
+# Edit pyproject.toml and increment the version number (e.g., 1.0.8 -> 1.0.9)
+
+# 3. Clean old builds
+rm -rf dist/*
+
+# 4. Build the package
+python -m build
 
-# Upload to PyPI
+# 5. Upload to PyPI using twine
 twine upload dist/*
 ```
 
+**Quick deployment (one-liner after version bump):**
+```bash
+source .venv/bin/activate && rm -rf dist/* && python -m build && twine upload dist/*
+```
+
+**Verify deployment:**
+```bash
+pip3 index versions mem-brain-mcp
+```
+
 ## License
 
 Same as Mem-Brain API project.

{mem_brain_mcp-1.0.9 → mem_brain_mcp-1.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mem-brain-mcp"
-version = "1.0.9"
+version = "1.1.1"
 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.9 → mem_brain_mcp-1.1.1}/src/mem_brain_mcp/__init__.py

@@ -1,4 +1,3 @@
 """Mem-Brain MCP Server - Exposes Mem-Brain API as MCP tools."""
 
-__version__ = "1.0.8"
-
+__version__ = "1.1.1"

{mem_brain_mcp-1.0.9 → mem_brain_mcp-1.1.1}/src/mem_brain_mcp/server.py

@@ -48,6 +48,7 @@ AGENT_INSTRUCTIONS = """You are an intelligent assistant with a persistent, evol
 | `search_memories(query, k=5)` | Before answering ANY personal question |
 | `get_memories(memory_ids)` | Need full details for specific IDs |
 | `add_memory(content, tags=[], category="")` | User reveals preference/goal/fact |
+| `get_stats()` | Check memory coverage and system health |
 | `delete_memories(memory_id)` | Memory is wrong or user requests deletion |
 
 ---
@@ -741,6 +742,80 @@ async def delete_memories(
         raise ToolError(f"Error deleting memories: {str(e)}")
 
 
+@mcp.tool()
+async def get_stats() -> str:
+    """Get comprehensive statistics about the memory system.
+
+    **Use this tool to:**
+    - Check how many memories you have stored
+    - See total link count and link density
+    - View top tags and memory distribution
+    - Understand your knowledge graph structure
+
+    **Why this matters:**
+    - Provides context about memory coverage
+    - Shows if the system is actively used
+    - Reveals patterns in what you store
+    - Helps identify gaps or over-representation
+
+    Returns formatted statistics including:
+    - Total memories count
+    - Total links count
+    - Average links per memory
+    - Top tags by frequency
+    - Memory categories/tags distribution
+
+    **Example:**
+    get_stats()
+    """
+    try:
+        logger.info("get_stats called - retrieving memory system statistics")
+        client = await _get_api_client()
+        result = await client.get_stats()
+
+        # Extract statistics
+        total_memories = result.get("total_memories", 0)
+        total_links = result.get("total_links", 0)
+        avg_links = result.get("avg_links_per_memory", 0)
+        top_tags = result.get("top_tags", [])
+
+        # Format response
+        lines = [
+            "📊 Memory System Statistics",
+            "",
+            f"Total Memories: {total_memories}",
+            f"Total Links: {total_links}",
+            f"Average Links per Memory: {avg_links:.2f}",
+        ]
+
+        # Add top tags if available
+        if top_tags:
+            lines.append("")
+            lines.append("Top Tags:")
+            for tag_data in top_tags[:10]:  # Show top 10
+                if isinstance(tag_data, dict):
+                    tag_name = tag_data.get("tag", "unknown")
+                    count = tag_data.get("count", 0)
+                    lines.append(f"  - {tag_name}: {count} memories")
+                else:
+                    lines.append(f"  - {tag_data}")
+
+        return "\n".join(lines)
+    except httpx.HTTPStatusError as e:
+        error_detail = e.response.text if e.response else "Unknown error"
+        logger.error(f"API error: {e.response.status_code} - {error_detail}")
+        if e.response.status_code == 401:
+            raise ToolError(
+                "Authentication failed. Please login using the 'login' tool or configure your JWT token in the MCP client headers."
+            )
+        raise ToolError(f"Failed to get statistics: HTTP {e.response.status_code} - {error_detail}")
+    except ToolError:
+        raise
+    except Exception as e:
+        logger.error(f"Unexpected error in get_stats: {e}", exc_info=True)
+        raise ToolError(f"Error getting statistics: {str(e)}")
+
+
 # ============================================================================
 # HELPER FUNCTIONS
 # ============================================================================