mem-brain-mcp 1.0.6__py3-none-any.whl

mem_brain_mcp-1.0.6.dist-info/METADATA

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: mem-brain-mcp
+Version: 1.0.6
+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
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <3.14,>=3.10
+Requires-Dist: fastmcp<3.0.0,>=2.0.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: uvicorn[standard]>=0.27.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.4.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Mem-Brain MCP Server
+
+MCP (Model Context Protocol) server that exposes Mem-Brain API functionality as standardized tools for AI agents. Built with [FastMCP](https://gofastmcp.com) for production-ready HTTP/SSE transport.
+
+## Features
+
+- **Memory Management**: Create, read, update, and delete memories
+- **Semantic Search**: Search memories using vector similarity
+- **Graph Operations**: Find paths and neighborhoods in the memory graph
+- **Statistics**: Get insights about your memory system
+- **Link Management**: Link and unlink memories
+- **HTTP/SSE Transport**: Run independently, accessible remotely
+- **CLI Interface**: Packaged for easy global execution
+
+## 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 `uvx`:
+
+```bash
+# Run using uvx (uses default API URL)
+uvx mem-brain-mcp
+
+# 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
+```
+
+### From Source
+
+1. Install using `uv` (recommended) or `pip`:
+
+```bash
+cd mem-brain-mcp
+uv pip install .
+```
+
+2. Run globally:
+
+```bash
+mem-brain-mcp
+```
+
+## Configuration
+
+The server reads configuration from environment variables or a `.env` file in the current working directory. Most settings have sensible defaults:
+
+```env
+# 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
+MCP_SERVER_PORT=8100
+
+# Logging
+LOG_LEVEL=INFO
+```
+
+**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 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`)
+
+```json
+{
+  "mcpServers": {
+    "mem-brain": {
+      "url": "http://localhost:8100/mcp",
+      "headers": {
+        "Authorization": "Bearer your-jwt-token"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+#### Option 1: Native Remote (Pro/Team plans)
+Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "mem-brain": {
+      "url": "http://your-deployed-url/mcp",
+      "headers": {
+        "Authorization": "Bearer your-jwt-token"
+      }
+    }
+  }
+}
+```
+
+#### Option 2: via CLI (Any plan)
+```json
+{
+  "mcpServers": {
+    "mem-brain": {
+      "command": "uvx",
+      "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-custom-api-url"
+      }
+    }
+  }
+}
+```
+
+## AWS ECS Deployment
+
+The MCP server can be deployed to AWS ECS (Fargate) with an Application Load Balancer.
+
+### Quick Start
+
+1. **Set up security groups** (see [aws/security-groups.md](./aws/security-groups.md))
+2. **Deploy using the script:**
+
+```bash
+cd mem-brain-mcp/aws
+./deploy.sh ap-south-1 membrain-mcp membrain-cluster membrain-mcp
+```
+
+For detailed instructions, see [aws/DEPLOYMENT.md](./aws/DEPLOYMENT.md).
+
+## Development
+
+### Running Tests
+```bash
+pytest
+```
+
+### Build and Publish
+```bash
+# Build the wheel
+python3 -m build
+
+# Upload to PyPI
+twine upload dist/*
+```
+
+## License
+
+Same as Mem-Brain API project.

mem_brain_mcp-1.0.6.dist-info/RECORD

@@ -0,0 +1,9 @@
+mem_brain_mcp/__init__.py,sha256=u8pOjQqzMWIWU9TmVSkCxEA_LeUDUzEEatvXMKa1REs,89
+mem_brain_mcp/__main__.py,sha256=H_mwoKm1FBmu4KzAcQcq-TXZqeNvlrAekAxB1s4F4hA,712
+mem_brain_mcp/client.py,sha256=qVZutTX1EyH1R00TOcxk29gzqELwNqzAuFIO8-8FXrw,8049
+mem_brain_mcp/config.py,sha256=xx2lBkCIeT85t0HxtORwZHSU3hZT_EdsThpfjwPJhbQ,1261
+mem_brain_mcp/server.py,sha256=tHmjdhQM2cH-iD9xA-oCzUPX5yaDh4ZxnCRq3B7fCFk,70799
+mem_brain_mcp-1.0.6.dist-info/METADATA,sha256=o7dYmpnRnchyvv7YZS7lmxPZGfcQLLP4dY1XuyDNJAE,5228
+mem_brain_mcp-1.0.6.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+mem_brain_mcp-1.0.6.dist-info/entry_points.txt,sha256=NH6QYQ-Sd8eJn5crpe_DL1PvGeUlL3y65968xPhmwG8,62
+mem_brain_mcp-1.0.6.dist-info/RECORD,,

mem_brain_mcp-1.0.6.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

mem_brain_mcp-1.0.6.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mem-brain-mcp = mem_brain_mcp.__main__:main