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

{mem_brain_mcp-1.0.0 → mem_brain_mcp-1.0.2}/.gitignore

@@ -51,3 +51,4 @@ tmp/
 
 
 
+

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mem-brain-mcp
-Version: 1.0.0
+Version: 1.0.2
 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
@@ -38,21 +38,40 @@ MCP (Model Context Protocol) server that exposes Mem-Brain API functionality as
 - **HTTP/SSE Transport**: Run independently, accessible remotely
 - **CLI Interface**: Packaged for easy global execution
 
-## Instant Execution (Recommended)
+## Installation
+
+### From PyPI (Recommended)
+
+Install from PyPI using `pip` or `uv`:
+
+```bash
+# Using pip
+pip install mem-brain-mcp
+
+# Using uv
+uv pip install mem-brain-mcp
+```
+
+Then run globally:
+
+```bash
+mem-brain-mcp
+```
+
+### Instant Execution with uvx
 
-You can run the MCP server instantly without manual installation using `uv`:
+You can run the MCP server instantly without manual installation using `uvx`:
 
 ```bash
-# Run using uvx (loads environment from .env or shell)
+# Run using uvx (uses default API URL)
 uvx mem-brain-mcp
 
-# Run with custom API URL
-export API_BASE_URL=http://your-api-alb-url.com
+# Override API URL or set JWT token if needed
+export API_BASE_URL=http://your-custom-api-url.com
+export MEMBRAIN_API_KEY=your-jwt-token-here
 uvx mem-brain-mcp
 ```
 
-## Installation
-
 ### From Source
 
 1. Install using `uv` (recommended) or `pip`:
@@ -70,13 +89,14 @@ mem-brain-mcp
 
 ## Configuration
 
-The server reads configuration from environment variables or a `.env` file in the current working directory:
+The server reads configuration from environment variables or a `.env` file in the current working directory. Most settings have sensible defaults:
 
 ```env
-# API Configuration
-API_BASE_URL=http://localhost:8000
-# NOTE: API_KEY is optional here - per-user API keys are configured in MCP clients
-API_KEY=your_api_key_here  # Optional: fallback for single-user scenarios
+# API Configuration (optional - defaults to production API)
+API_BASE_URL=http://membrain-api-alb-1094729422.ap-south-1.elb.amazonaws.com
+# NOTE: MEMBRAIN_API_KEY is actually a JWT access token (from login/signup)
+# Per-user JWT tokens are typically configured in MCP clients via headers
+MEMBRAIN_API_KEY=your_jwt_token_here  # Optional: fallback for single-user scenarios
 
 # MCP Server Configuration
 MCP_SERVER_HOST=0.0.0.0
@@ -86,9 +106,11 @@ MCP_SERVER_PORT=8100
 LOG_LEVEL=INFO
 ```
 
-## Per-User API Key Configuration
+**Note**: The `API_BASE_URL` defaults to the production Mem-Brain API endpoint, so you typically don't need to set it unless you're using a custom API instance.
+
+## Per-User JWT Token Configuration
 
-Each user must configure their own API key in their MCP client for proper user isolation. The server extracts tokens from request headers.
+Each user must configure their own JWT access token in their MCP client for proper user isolation. The server extracts tokens from request headers. Get your JWT token by logging in or signing up to the Mem-Brain API.
 
 ### Cursor IDE (`~/.cursor/mcp.json`)
 
@@ -129,10 +151,20 @@ Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/
   "mcpServers": {
     "mem-brain": {
       "command": "uvx",
-      "args": ["mem-brain-mcp"],
+      "args": ["mem-brain-mcp"]
+    }
+  }
+}
+```
+
+**Note**: After installing from PyPI, you can also use `mem-brain-mcp` directly. The API URL is set by default, but you can override it if needed:
+```json
+{
+  "mcpServers": {
+    "mem-brain": {
+      "command": "mem-brain-mcp",
       "env": {
-        "API_BASE_URL": "http://your-deployed-url",
-        "JWT_SECRET_KEY": "your-secret"
+        "API_BASE_URL": "http://your-custom-api-url"
       }
     }
   }

{mem_brain_mcp-1.0.0 → mem_brain_mcp-1.0.2}/README.md

@@ -12,21 +12,40 @@ MCP (Model Context Protocol) server that exposes Mem-Brain API functionality as
 - **HTTP/SSE Transport**: Run independently, accessible remotely
 - **CLI Interface**: Packaged for easy global execution
 
-## Instant Execution (Recommended)
+## Installation
+
+### From PyPI (Recommended)
+
+Install from PyPI using `pip` or `uv`:
+
+```bash
+# Using pip
+pip install mem-brain-mcp
+
+# Using uv
+uv pip install mem-brain-mcp
+```
+
+Then run globally:
+
+```bash
+mem-brain-mcp
+```
+
+### Instant Execution with uvx
 
-You can run the MCP server instantly without manual installation using `uv`:
+You can run the MCP server instantly without manual installation using `uvx`:
 
 ```bash
-# Run using uvx (loads environment from .env or shell)
+# Run using uvx (uses default API URL)
 uvx mem-brain-mcp
 
-# Run with custom API URL
-export API_BASE_URL=http://your-api-alb-url.com
+# Override API URL or set JWT token if needed
+export API_BASE_URL=http://your-custom-api-url.com
+export MEMBRAIN_API_KEY=your-jwt-token-here
 uvx mem-brain-mcp
 ```
 
-## Installation
-
 ### From Source
 
 1. Install using `uv` (recommended) or `pip`:
@@ -44,13 +63,14 @@ mem-brain-mcp
 
 ## Configuration
 
-The server reads configuration from environment variables or a `.env` file in the current working directory:
+The server reads configuration from environment variables or a `.env` file in the current working directory. Most settings have sensible defaults:
 
 ```env
-# API Configuration
-API_BASE_URL=http://localhost:8000
-# NOTE: API_KEY is optional here - per-user API keys are configured in MCP clients
-API_KEY=your_api_key_here  # Optional: fallback for single-user scenarios
+# API Configuration (optional - defaults to production API)
+API_BASE_URL=http://membrain-api-alb-1094729422.ap-south-1.elb.amazonaws.com
+# NOTE: MEMBRAIN_API_KEY is actually a JWT access token (from login/signup)
+# Per-user JWT tokens are typically configured in MCP clients via headers
+MEMBRAIN_API_KEY=your_jwt_token_here  # Optional: fallback for single-user scenarios
 
 # MCP Server Configuration
 MCP_SERVER_HOST=0.0.0.0
@@ -60,9 +80,11 @@ MCP_SERVER_PORT=8100
 LOG_LEVEL=INFO
 ```
 
-## Per-User API Key Configuration
+**Note**: The `API_BASE_URL` defaults to the production Mem-Brain API endpoint, so you typically don't need to set it unless you're using a custom API instance.
+
+## Per-User JWT Token Configuration
 
-Each user must configure their own API key in their MCP client for proper user isolation. The server extracts tokens from request headers.
+Each user must configure their own JWT access token in their MCP client for proper user isolation. The server extracts tokens from request headers. Get your JWT token by logging in or signing up to the Mem-Brain API.
 
 ### Cursor IDE (`~/.cursor/mcp.json`)
 
@@ -103,10 +125,20 @@ Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/
   "mcpServers": {
     "mem-brain": {
       "command": "uvx",
-      "args": ["mem-brain-mcp"],
+      "args": ["mem-brain-mcp"]
+    }
+  }
+}
+```
+
+**Note**: After installing from PyPI, you can also use `mem-brain-mcp` directly. The API URL is set by default, but you can override it if needed:
+```json
+{
+  "mcpServers": {
+    "mem-brain": {
+      "command": "mem-brain-mcp",
       "env": {
-        "API_BASE_URL": "http://your-deployed-url",
-        "JWT_SECRET_KEY": "your-secret"
+        "API_BASE_URL": "http://your-custom-api-url"
       }
     }
   }

{mem_brain_mcp-1.0.0 → mem_brain_mcp-1.0.2}/aws/DEPLOYMENT.md

@@ -336,7 +336,7 @@ The MCP server requires the following environment variables (set in the task def
 - `MCP_SERVER_PORT`: Server port (default: `8100`)
 - `LOG_LEVEL`: Logging level (default: `INFO`)
 
-**Note**: `API_KEY` is optional in the server configuration. Per-user API keys are configured in MCP clients (Cursor, Claude Desktop, etc.) via request headers.
+**Note**: `MEMBRAIN_API_KEY` is optional in the server configuration. Per-user JWT tokens are configured in MCP clients (Cursor, Claude Desktop, etc.) via request headers.
 
 ## Updating the Deployment
 

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

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

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

{mem_brain_mcp-1.0.0 → mem_brain_mcp-1.0.2}/src/mem_brain_mcp/config.py

@@ -16,11 +16,16 @@ class Settings(BaseSettings):
     )
 
     # API Configuration
-    api_base_url: str = "http://localhost:8000"
-    api_key: Optional[str] = None
+    api_base_url: str = "http://membrain-api-alb-1094729422.ap-south-1.elb.amazonaws.com"
+    membrain_api_key: Optional[str] = None
     # NOTE: default_user_id is deprecated and unused.
     # Per-user API keys are extracted from request headers for proper isolation.
     # Each MCP client should configure their own API key via headers.
+    
+    @property
+    def api_key(self) -> Optional[str]:
+        """Backward compatibility property for api_key."""
+        return self.membrain_api_key
 
     # MCP Server Configuration
     mcp_server_host: str = "0.0.0.0"