Metadata tagging

.env

@@ -1 +1 @@
-MEM0_API_KEY=<your-api-key>
+MEM0_API_KEY=m0-A6mOkNpchMyMIwF5BYvPG2CIXOmRVnr54d0cmw50

.env.example

@@ -0,0 +1 @@
+MEM0_API_KEY=<your-api-key>

.gitignore

@@ -0,0 +1,48 @@
+# Python bytecode
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+mem0_mcp.egg-info/
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# Environment variables
+.env
+
+# Mac OS specific files
+.DS_Store
+
+# Editor specific files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Python version file
+.python-version
+
+# Cache and logs
+.cache/
+.pytest_cache/
+.coverage
+htmlcov/
+coverage.xml
+*.cover
+logs/
+*.log
+
+# Dependency files
+uv.lock
+
+# Temporary files
+tmp/
+temp/ 

README.md

@@ -38,23 +38,161 @@ MEM0_API_KEY=your_api_key_here
 uv run main.py
 ```
 
-2. In Cursor, connect to the SSE endpoint, follow this [doc](https://docs.cursor.com/context/model-context-protocol) for reference:
+Or if you're using the metadata tagging version:
 
+```bash
+uv run main_metadata_tagging.py
 ```
+
+2. In Cursor, connect to the SSE endpoint, follow this [doc](https://docs.cursor.com/context/model-context-protocol) for reference:
+
+```text
 http://0.0.0.0:8080/sse
 ```
 
 3. Open the Composer in Cursor and switch to `Agent` mode.
 
-## Demo with Cursor
+## Prompt Examples
+
+Here are examples of how to effectively use each of the tools provided by this MCP server:
+
+### Adding Coding Preferences
+
+When you want to store a code snippet, implementation pattern, or programming knowledge, use prompts like these:
+
+```text
+Please save this React custom hook for fetching data with caching:
+
+import { useState, useEffect } from 'react';
+
+export const useFetchWithCache = (url, options = {}) => {
+  const [data, setData] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+
+  useEffect(() => {
+    // Check cache first
+    const cachedData = sessionStorage.getItem(`cache_${url}`);
+
+    if (cachedData) {
+      setData(JSON.parse(cachedData));
+      setLoading(false);
+      return;
+    }
+
+    const fetchData = async () => {
+      try {
+        const response = await fetch(url, options);
+        if (!response.ok) throw new Error(`HTTP error ${response.status}`);
+
+        const result = await response.json();
+
+        // Cache the result
+        sessionStorage.setItem(`cache_${url}`, JSON.stringify(result));
+
+        setData(result);
+      } catch (err) {
+        setError(err.message);
+      } finally {
+        setLoading(false);
+      }
+    };
+
+    fetchData();
+  }, [url, JSON.stringify(options)]);
+
+  return { data, loading, error };
+};
+
+This is a React hook (React 18) that fetches data from an API and implements caching using sessionStorage to improve performance. It handles loading states and error conditions gracefully.
+
+```
+
+For project-specific storage (with metadata tagging):
+
+```text
+Please save this PostgreSQL query pattern for efficient pagination in the "database-patterns" project:
+
+SELECT *
+FROM table_name
+WHERE id > (SELECT id FROM table_name ORDER BY id LIMIT 1 OFFSET $offset)
+ORDER BY id
+LIMIT $limit;
+
+This pattern uses keyset pagination which is more efficient than OFFSET/LIMIT for large datasets as it avoids scanning through offset rows each time. It works best with indexed columns like id.
+```
+
+### Retrieving All Coding Preferences
+
+When you want to review all stored coding patterns:
+
+```text
+
+Please show me all the coding patterns we've stored so far.
+
+```
+
+For project-specific retrieval:
+
+```text
 
-https://github.com/user-attachments/assets/56670550-fb11-4850-9905-692d3496231c
+Can you retrieve all the coding preferences we've saved for the "database-patterns" project?
+
+```
+
+### Searching Coding Preferences
+
+When you need to find specific coding patterns or solutions:
+
+```text
+
+Find me any React hooks we've saved for handling API requests.
+
+```
+
+```text
+
+Search for efficient pagination patterns in SQL databases.
+
+```
+
+```text
+
+Do we have any examples of implementing authentication in Express.js?
+
+```
+
+For project-specific searches:
+
+```text
+
+Within the "frontend-components" project, search for any modal implementation patterns.
+
+```
+
+## Effective Workflow
+
+For the most effective use of this system:
+
+1. **Consistently Store Valuable Code**: Whenever you encounter or create a useful code pattern, implementation, or solution, store it with thorough documentation.
+
+2. **Always Search First**: Before implementing a solution, search the stored preferences to see if you already have a pattern for it.
+
+3. **Use Project Tags**: Organize related code patterns using project tags to keep your knowledge base well-structured.
+
+4. **Include Context**: When storing code, always include:
+   - The programming language/framework and version
+   - Any dependencies or prerequisites
+   - Example usage
+   - Edge cases or limitations
+   - Performance considerations
 
 ## Features
 
 The server provides three main tools for managing code preferences:
 
 1. `add_coding_preference`: Store code snippets, implementation details, and coding patterns with comprehensive context including:
+
    - Complete code with dependencies
    - Language/framework versions
    - Setup instructions
@@ -79,9 +217,10 @@ This implementation allows for a persistent coding preferences system that can b
 
 By default, the server runs on 0.0.0.0:8080 but is configurable with command line arguments like:
 
-```
+```bash
+
 uv run main.py --host <your host> --port <your port>
+
 ```
 
 The server exposes an SSE endpoint at `/sse` that MCP clients can connect to for accessing the coding preferences management tools.
-